跳到內文
Cheapest Imagen
指南

文生圖

用 Cheapest Imagen API 做文生圖:把提示詞送到 /v1/images/generations,並選擇模型、尺寸、品質、張數和輸出檔案格式。

把提示詞送到 POST /v1/images/generations。只有 model 和 prompt 是必填的。

curl https://api.cheapestimagen.com/v1/images/generations \
  -H "Authorization: Bearer $YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "黃昏的燈塔,油畫風格",
    "n": 2,
    "size": "1536x1024",
    "quality": "high"
  }'

選填參數

欄位作用可用值
n生成幾張1 到 10,預設 1
size寬和高auto 或 1K、2K、4K 尺寸,見比例和尺寸
quality算圖品質,各檔同價auto、low、medium、high;gpt-image-2.5-sunburst 另有 xhigh、max
background透明或不透明背景auto、opaque、transparent
output_format檔案格式所有模型都可用 png(預設)、jpeg、webp;gpt-image-2.6 及其 flare、sunburst 版本可用 gif;gpt-image-2.6 可用 svg
output_compressionjpeg、webp 的品質0 到 100,預設 100
moderation內容審核的嚴格程度auto、low
response_format回傳圖片資料還是連結b64_json(預設)、url

目前沒有模型能直接生成透明背景:OpenAI 已撤下 GPT Image 模型的透明背景預覽,現在只會回傳帶底色的圖。請求裡帶 background: transparent 會回傳 400,代碼為 unsupported_parameter。需要去背的話,可以在提示詞裡要求純色背景,拿到圖後再去掉背景。

輸出格式

和 OpenAI 官方 API 一樣,所有模型都能輸出 PNG、JPEG、WebP。大部分模型出的是 PNG,我們在 Cloudflare 網路內把它轉成你要的 JPEG 或 WebP(約 0.1 到 0.4 秒;2 MB 的 PNG 轉完約 250 KB)。gpt-image-2.6-flare 和 gpt-image-2.6-sunburst 自己就能出 JPEG 和 WebP。

模型PNGJPEGWebPGIFSVG
gpt-image-2、gpt-image-2.5、gpt-image-2-adobe支援支援支援––
gpt-image-2.6支援支援支援支援支援
gpt-image-2.5-flare、gpt-image-2.5-sunburst支援支援支援––
gpt-image-2.6-flare、gpt-image-2.6-sunburst支援支援支援支援–
Nano Banana(所有版本)支援支援支援––

「–」會回傳 400。output_compression 在所有模型上都用來設定 JPEG、WebP 的品質(預設 100)。GIF 可能要 3 到 5 分鐘。檔案的實際類型請看連結的副檔名和 Content-Type。

一次請求扣多少

一次請求扣 n 乘以模型積分:GPT Image 2、2.5、2.6 每張 8 積分,Nano Banana 2 和 2.1 每張 12 積分,Nano Banana Pro、gpt-image-2-adobe 以及 flare 版本每張 20 積分,sunburst 版本每張 25 積分,Nano Banana 穩定通道每張 60 到 180 積分。如果實際回傳的張數比你要的少,只按收到的張數扣。

同一個請求送了兩次

加一個請求標頭 Idempotency-Key,值由你自己訂。第一個請求還在進行或已經成功時,再用同一個值請求會回傳 409,不會再次生成和扣費。請求失敗後,這個值可以重新使用。

本頁內容