跳轉到主要內容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "將兩張參考圖融合成賽博朋克風格插畫海報",
    "image_urls": [
      "https://example.com/input-a.png",
      "https://example.com/input-b.png"
    ],
    "size": "1:1",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • 與圖像生成使用同一端點 /v1/images/generations
  • 請求中包含 image_urls 即自動切換爲編輯模式
  • 支持多參考圖融合（最多 16 張）、局部重繪（mask）
  • 參考圖須爲公網可訪問的 PNG / JPG，單張 ≤ 50MB
編輯模式的調用方式與生成完全兼容：只需在生成請求基礎上加入 image_urls（和可選的 mask_url）即可，無需切換端點。

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key：訪問 API Key 管理頁面 獲取您的 API Key
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
預設值:"gpt-image-2"
必填
固定填寫 gpt-image-2
​
prompt
string
必填
描述期望的編輯效果示例："把背景換成星空，保持主體人物不變"
​
image_urls
string[]
必填
參考圖 URL 數組（觸發編輯模式的關鍵字段）
  • 最多 16 張
  • 必須是公網可訪問的穩定 URL（PNG / JPG，單張 ≤ 50MB）
  • 可使用 上傳圖片接口 獲取 URL
​
mask_url
string
遮罩圖 URL，用於局部重繪（inpainting）
  • 須爲 PNG 格式，且包含 Alpha 通道
  • 透明區域（alpha = 0）爲待重繪區域，不透明區域保持原樣
  • 尺寸須與第一張參考圖一致
​
size
string
預設值:"1:1"
輸出圖像寬高比支持 13 種比例，也可傳 auto：1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 21:9 · 9:21
​
resolution
string
預設值:"1k"
分辨率檔位：1k / 2k / 4k1K / 2K 支持全部 13 個比例；4K 僅支持 6 個比例（16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）
​
quality
string
預設值:"high"
圖片質量：low / medium / high
​
n
integer
預設值:1
生成數量，範圍 1 ~ 10
​
output_format
string
預設值:"png"
輸出格式：png / jpeg
Azure OpenAI 不支持 webp 格式。
​
output_compression
integer
預設值:100
JPEG 壓縮強度，範圍 0–100（僅對 output_format: "jpeg" 有效）

​
Response

​
id
string
任務唯一標識符，用於查詢任務狀態
​
object
string
固定爲 generation.task
​
status
string
任務狀態：queued / in_progress / completed / failed
​
progress
integer
任務進度百分比（0-100）
​
created_at
integer
任務創建時間戳（Unix 時間戳）
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "將兩張參考圖融合成賽博朋克風格插畫海報",
    "image_urls": [
      "https://example.com/input-a.png",
      "https://example.com/input-b.png"
    ],
    "size": "1:1",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}