文生圖
用 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_compression | jpeg、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。
| 模型 | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
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,不會再次生成和扣費。請求失敗後,這個值可以重新使用。