GPT-Image-2 圖片生成

• 模型：gpt-image-2
• 端點：POST https://apimaster.ai/v1/images/generations
• 模式：非同步 — 回傳 task_id，然後輪詢任務
• 功能：文字轉圖片；圖片轉圖片，最多可搭配 16 張參考圖片（URL 與 base64 混合）

認證

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

請求主體參數

欄位	類型	必填	備註
model	string	是	gpt-image-2
prompt	string	是	場景描述；適用安全審核
n	integer	否	僅 1（數字，無引號）
size	string	否	長寬比，預設 1:1
resolution	string	否	1k / 2k / 4k，預設 1k
image_urls	array	否	參考圖片 → 圖片轉圖片
official_fallback	boolean	否	官方通道降級，預設 false

size 值

auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21，或像素字串如 3840x2160。

解析度（範例像素）

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

所有 15 種比例皆支援 4K。

image_urls

• 最多 16 張圖片
• 可混合使用公開 URL 與 base64 data URI
• 省略 size 則沿用輸入解析度；設定 size 可強制輸出長寬比

範例

最小文字轉圖片

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

提交回應

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP 狀態碼	含義
400	參數無效
401	API 金鑰錯誤
402	餘額不足
429	請求頻率限制

輪詢任務結果

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

圖片 URL：data.result.images[0].url[0]

狀態	含義
submitted	已排隊
processing	執行中
completed	已完成
failed	請查看錯誤

建議在 10–20 秒後開始輪詢，每 3–5 秒一次。批次查詢：POST https://apimaster.ai/v1/tasks/batch，主體為 {"task_ids":[...]}。

備註

• 僅支援非同步 — 建立請求的回應中不會包含同步圖片 URL。
• 建議使用 size 指定長寬比，避免在 prompt 中重複描述比例。
• 計費依解析度等級而定；請至控制台查看您的帳戶資訊。

與官方通道比較。