88API88API
使用指南AI 應用API 文件幫助支援
影像(Image)

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-21K (預設) / 2K / 4K
size 填像素
最多 4 張 (本機檔案)固定 1 張按張
gpt-image-2.5-flare1K (預設) / 2K / 4K
size 填像素
最多 10 張 (本機檔案)固定 1 張按張
gpt-image-2.5-sunburst1K (預設) / 2K / 4K
size 填像素
最多 10 張 (本機檔案)固定 1 張按張
az-gpt-image-21K (預設) / 2K / 4K
size 填像素
最多 10 張 (本機檔案 / Data URI / 公開 URL)最多 10 張按 token
az-gpt-image-2.5-flare1K (預設) / 2K / 4K
size 填像素
最多 10 張 (本機檔案 / Data URI / 公開 URL)最多 10 張按 token
az-gpt-image-2.5-sunburst1K (預設) / 2K / 4K
size 填像素
最多 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

模型qualitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / high不支援不支援b64_json / url
gpt-image-2.5-flarelow / medium / high不支援不支援b64_json / url
gpt-image-2.5-sunburstlow / medium / high不支援不支援b64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_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)之間。

下表是各檔位建議使用的尺寸,所有模型通用:

比例1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

不傳 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"
  }'

請求參數

參數型別必填說明
modelstring是圖片模型名稱,例如 gpt-image-2。
promptstring是圖片內容描述。建議寫清楚主體、構圖、風格、光線和畫幅。
sizestring否像素尺寸,規則見上文「尺寸」。
qualitystring否gpt-image-* 支援 low、medium、high。az-gpt-image-2 支援 low、medium、high、auto;az-gpt-image-2.5-* 另支援 xhigh、max。未指定時按 low 生成。
ninteger否生成張數。az-gpt-image-* 支援 1 至 10;gpt-image-* 每次請求回傳 1 張,需要多張時請送出多個請求。
response_formatstring否b64_json(預設)或 url。選 url 時回傳 88API 的圖片連結。
backgroundstring否僅 az-gpt-image-*:transparent、opaque、auto。
output_formatstring否僅 az-gpt-image-*:png(預設)、webp、jpeg。
output_compressioninteger否僅 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 時,表示請求送到了錯誤的介面。