Skip to main content
POST
  • 統一的圖像生成 API 接口
  • 通過 model 參數選擇 gpt-image-2-vip
  • 參數與 gpt-image-2 保持一致
  • 支持文生圖、單圖參考和多圖參考生成
  • 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls / reference_images 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"gpt-image-2-vip"
必填
圖像生成模型名稱示例:"gpt-image-2-vip"
string
必填
圖像生成的文本描述最長 32,000 個字符(GPT image models 官方上限)
string
預設值:"1:1"
輸出圖像比例支持以下預設比例:1:13:22:34:33:45:44:516:99:162:11:221:99:21也支持使用 寬:高 格式傳入任意比例,例如 1:37:4,但必須符合下方的尺寸限制。也可以傳 auto 讓上游自動選擇尺寸,但最終寬高比和像素尺寸無法保證。
string
預設值:"1k"
輸出分辨率檔位支持值:1k2k4k

任意分辨率

除上述預設比例外,可以通過 size寬:高 格式請求任意比例。服務端會根據 resolution 檔位計算實際像素尺寸,結果必須滿足:
  • 寬和高都必須是 16 像素的倍數
  • 長邊最大可達 3,840 像素(4K)
  • 寬高比最大可達 3:1
  • 像素總數範圍為 655,360–8,294,400
例如:
  • size: "1:3"resolution: "2k"1024x3072
  • size: "7:4"resolution: "1k"1344x768
string
預設值:"medium"
圖片質量
  • low — 快速省錢,適合草稿/預覽
  • medium — 平衡速度與質量
  • high — 最高精度,適合正式出圖
integer
預設值:1
生成圖像的數量默認:1
string
預設值:"url"
返回格式固定返回圖片 URL,推薦使用 url
string[]
參考圖 URL 列表,用於圖生圖⚠️ 僅支持 URL 格式(不再支持 base64)
  • 公開可訪問的圖片 URL(http:// 或 https://)
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL
  • 支持單圖和多圖參考
string[]
向後兼容的參考圖字段在 ToAPIs 中會自動歸一化爲 reference_images
string
ToAPIs 標準任務完成回調。需先設定 Token HTTPS URL 與密鑰,且只能同源覆蓋。詳見 Webhook

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間戳(Unix 時間戳)