跳轉到主要內容
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": "星空下的古老城堡，電影感光影，超寫實風格",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}
  • OpenAI 官方 gpt-image-2 模型
  • 異步處理模式，返回任務 ID 用於後續查詢
  • 支持文生圖、多參考圖圖生圖、遮罩局部重繪（inpainting）
  • 支持 13 種寬高比，可選 1K / 2K / 4K 三檔分辨率
  • 單次最多生成 4 張圖，參考圖最多 16 張
注意：gpt-image-2 不支持透明背景，傳入 background: "transparent" 會被靜默降級爲 auto。

​
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
必填
圖像生成的文本描述支持中英文，建議詳細描述場景、風格和構圖
​
size
string
預設值:"1:1"
畫面寬高比支持以下比例，也可傳 auto 由服務端根據 prompt 自動選擇：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
4K 檔僅支持 6 個比例：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21，其餘比例請使用 1K 或 2K。
​
resolution
string
預設值:"1k"
分辨率檔位
  • 1k — 1024 基準，速度快，日常夠用（默認）
  • 2k — 2048 基準，適合海報 / 高清需求
  • 4k — 3840 基準，僅支持上述 6 個比例，high 質量下耗時可達 130s

​
尺寸對照表

size1K2K4K
1:11024x10242048x2048不支持
3:21536x10242048x1360不支持
2:31024x15361360x2048不支持
4:31024x7682048x1536不支持
3:4768x10241536x2048不支持
5:41280x10242560x2048不支持
4:51024x12802048x2560不支持
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840
​
quality
string
預設值:"high"
圖片質量
  • low — 快速省錢，適合草稿/預覽
  • medium — 平衡速度與質量
  • high — 最高精度，默認值（4K + high 耗時可達 120s+）
​
output_format
string
預設值:"png"
輸出格式
  • png — 默認
  • jpeg — 文件更小（支持壓縮）
Azure OpenAI 不支持 webp 格式。
​
output_compression
integer
預設值:100
JPEG 壓縮強度，範圍 0–100（0 不壓縮，100 最大壓縮，默認 100）僅對 output_format: "jpeg" 有效
​
n
integer
預設值:1
生成圖片張數取值範圍：1 ~ 10
​
image_urls
string[]
參考圖 URL 數組，用於圖生圖
  • 最多 16 張，須爲公網可訪問的穩定 URL
  • 可先使用 上傳圖片接口 獲取 URL
​
mask_url
string
遮罩圖 URL，用於局部重繪（inpainting）需搭配 image_urls 使用，遮罩圖尺寸須與首張參考圖一致，且需包含 Alpha 通道（透明區域爲待重繪區域）

​
Response

​
id
string
任務唯一標識符，用於查詢任務狀態
​
object
string
對象類型，固定爲 generation.task
​
model
string
使用的模型名稱
​
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": "星空下的古老城堡，電影感光影，超寫實風格",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

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