OpenAI 圖片模型 API
gpt-image-2、gpt-image-2.5 與 az-gpt-image 系列圖片模型的介面、尺寸、品質檔位、參考圖和透明背景說明。
適用範圍
本頁介紹 OpenAI 圖片模型(gpt-image-* 與 az-gpt-image-*)的圖片介面。Gemini 圖片模型請參閱 Gemini 圖片模型 API,Grok 圖片模型請參閱 Grok 圖片模型 API。
介面選擇
OpenAI 圖片模型只使用圖片介面,請勿以 /v1/chat/completions 或 /v1/responses 代替:
| 用途 | 請求方法 | 端點 |
|---|---|---|
| 文生圖 | POST | /v1/images/generations |
| 圖片編輯 | POST | /v1/images/edits |
模型與能力
| 模型 | 解析度 | 參考圖 | 單次張數 | 計費 |
|---|---|---|---|---|
gpt-image-2 | 1K (預設) / 2K / 4Ksize 填像素 | 最多 4 張 (本機檔案) | 固定 1 張 | 按張 |
gpt-image-2.5-flare | 1K (預設) / 2K / 4Ksize 填像素 | 最多 10 張 (本機檔案) | 固定 1 張 | 按張 |
gpt-image-2.5-sunburst | 1K (預設) / 2K / 4Ksize 填像素 | 最多 10 張 (本機檔案) | 固定 1 張 | 按張 |
az-gpt-image-2 | 1K (預設) / 2K / 4Ksize 填像素 | 最多 10 張 (本機檔案 / Data URI / 公開 URL) | 最多 10 張 | 按 token |
az-gpt-image-2.5-flare | 1K (預設) / 2K / 4Ksize 填像素 | 最多 10 張 (本機檔案 / Data URI / 公開 URL) | 最多 10 張 | 按 token |
az-gpt-image-2.5-sunburst | 1K (預設) / 2K / 4Ksize 填像素 | 最多 10 張 (本機檔案 / Data URI / 公開 URL) | 最多 10 張 | 按 token |
支援的比例:1:1 (預設) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2
| 模型 | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | 不支援 | 不支援 | b64_json / url |
gpt-image-2.5-flare | low / medium / high | 不支援 | 不支援 | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | 不支援 | 不支援 | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
兩組模型的請求方法相同,差別在於可用參數和計費方式:
gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst:按張計費,價格與尺寸、品質檔位無關。支援size、quality,每次請求回傳 1 張。az-gpt-image-2、az-gpt-image-2.5-flare、az-gpt-image-2.5-sunburst:支援完整的 OpenAI Images 參數,包括透明背景background、輸出格式output_format、單次多張n(最多 10)、串流預覽,以及 JSON 格式的編輯請求。按 token 計費,費用隨尺寸和品質檔位變化。
實際可用模型以控制台回傳的模型列表為準。
驗證
所有請求都需要攜帶 88API 的存取令牌:
Authorization: Bearer $API_KEY
Content-Type: application/json尺寸
size 必須寫成像素 寬x高,不接受 1K、2K、4K 這類字串。合法尺寸需要同時符合:
- 寬和高都是 16 的倍數;
- 最長邊不超過 3840;
- 長邊與短邊之比不超過 3:1;
- 總像素介於 655,360(約 816×816)到 8,294,400(3840×2160)之間。
下表是各檔位建議使用的尺寸,所有模型通用:
| 比例 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
不傳 size 或傳 auto 時,由模型自行決定尺寸。不符合上述規則的尺寸可能被拒絕或被自動調整,請在送出請求前自行檢查。
文生圖
請求
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一隻坐在窗邊的橘貓,午後的自然光,寫實攝影風格",
"size": "2048x2048",
"quality": "medium"
}'請求參數
| 參數 | 型別 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | 圖片模型名稱,例如 gpt-image-2。 |
prompt | string | 是 | 圖片內容描述。建議寫清楚主體、構圖、風格、光線和畫幅。 |
size | string | 否 | 像素尺寸,規則見上文「尺寸」。 |
quality | string | 否 | gpt-image-* 支援 low、medium、high。az-gpt-image-2 支援 low、medium、high、auto;az-gpt-image-2.5-* 另支援 xhigh、max。未指定時按 low 生成。 |
n | integer | 否 | 生成張數。az-gpt-image-* 支援 1 至 10;gpt-image-* 每次請求回傳 1 張,需要多張時請送出多個請求。 |
response_format | string | 否 | b64_json(預設)或 url。選 url 時回傳 88API 的圖片連結。 |
background | string | 否 | 僅 az-gpt-image-*:transparent、opaque、auto。 |
output_format | string | 否 | 僅 az-gpt-image-*:png(預設)、webp、jpeg。 |
output_compression | integer | 否 | 僅 az-gpt-image-*,0 至 100,只對 jpeg、webp 生效。 |
回應範例
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}預設回傳 data[].b64_json;請求時指定 "response_format": "url" 則回傳 data[].url。
圖片編輯
圖片編輯使用 /v1/images/edits。上傳本機圖片時使用 multipart/form-data,多張參考圖請重複傳 image[]。最多 10 張(gpt-image-2 最多 4 張),支援 PNG、JPEG、WebP。
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=gpt-image-2" \
-F "image[]=@person.png" \
-F "image[]=@product.png" \
-F "prompt=讓第一張圖中的人物手持第二張圖中的產品,保持人物和產品外觀不變" \
-F "size=1536x1024"參考圖按上傳順序編號,提示詞裡可以用「第一張」「第二張」指稱。
JSON 編輯請求(僅 az-gpt-image-*)
az-gpt-image-* 也支援 JSON 格式的編輯請求,參考圖可以是 Data URI 或公開網址:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2.5-flare",
"prompt": "把背景替換為淺藍色攝影棚",
"images": [
{ "image_url": "data:image/png;base64,..." },
{ "image_url": "https://example.com/reference.png" }
],
"size": "1024x1024"
}'gpt-image-* 請使用 multipart 上傳。
透明背景(僅 az-gpt-image-*)
需要透明背景的貼圖、圖示或去背圖片時,將 background 設為 transparent,並使用 png 或 webp 輸出:
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2",
"prompt": "一隻舉著「加油」牌子的熊貓貼圖,乾淨的描邊",
"size": "1024x1024",
"background": "transparent",
"output_format": "png"
}'jpeg不支援透明,搭配transparent時會回傳不透明圖片。- 編輯時傳
transparent可以去除背景;參考圖本身是透明的,輸出也會保留透明。 opaque不能完全保證不透明:提示詞明確要求「貼圖」「無背景」時,仍可能回傳透明圖片。
串流預覽(僅 az-gpt-image-*)
設定 "stream": true 和 "partial_images": 1 至 3,介面會以 SSE 回傳 image_generation.partial_image 中間預覽,最後一個事件 image_generation.completed 帶有最終圖片和用量;編輯請求的事件名稱為 image_edit.*。
計費說明
gpt-image-*按成功回傳的張數計費,與尺寸、品質檔位無關。az-gpt-image-*按 token 計費:文字輸入、圖片輸入(參考圖)、圖片輸出分別計價。輸出 token 只取決於尺寸和品質檔位,檔位越高費用越高;az-gpt-image-2.5-*同名檔位的 token 低於az-gpt-image-2(2.5 的high約等於 2 的medium)。- 請求失敗不扣費。
重要限制
- 不要把這些模型的請求送到
/v1/responses或/v1/chat/completions。 - 不支援
mask局部重繪:傳入的遮罩不會按區域重繪,需要局部修改時請在提示詞裡描述位置。 - 不支援
input_fidelity參數。 - 不建議使用 GIF 作為參考圖,請先轉換為 PNG。
- 高品質檔位和 4K 尺寸可能需要 1 至 2 分鐘,
az-gpt-image-2.5-*的max檔最長約 2 分半,用戶端逾時建議設定為 5 分鐘以上。 - 回傳
Invalid size ...時,請按上文「尺寸」的規則檢查size。 - 回傳
This model does not support image generation.或image_model_wrong_endpoint時,表示請求送到了錯誤的介面。