跳到主要内容

GPT Image 2.5 · POST /v1/images/generations · 文生图 / 图生图

POST 
/v1/images/generations

GPT Image 2.5​

公开模型名只有 gpt-image-2.5-sunburst 和 gpt-image-2.5-flare。不要把分辨率写进模型名，也不要再追加其它后缀。

  • resolution 或 image_size：1K、2K、4K。不传时按 1K。gpt-image-2 不使用这两个字段，尺寸仍用 size。
  • 参考图最多 16 张，字段可用 images、image、image_urls、image_url。超过 16 张会被拒绝。
  • 不传 async 时，接口等待生成完成后直接返回 data[].url。网关等待有时限，超时请改传 "async": true，再用 GET /v1/images/generations/{task_id} 查询。
  • 传 "async": true 时立即返回任务。响应和任务里的 model 保持请求时的公开名。

cURL：sunburst 异步​

curl --location --request POST 'https://api.dshub.top/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "一张干净的产品海报，白底，柔和棚拍光",
    "resolution": "2K",
    "images": ["https://example.com/reference.png"],
    "async": true
  }'

cURL：flare 同步​

curl --location --request POST 'https://api.dshub.top/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2.5-flare",
    "prompt": "一张干净的产品海报，白底，柔和棚拍光",
    "image_size": "1K"
  }'

Request​

Responses​

提交成功。响应里的 model 保持请求时的公开名。

Response Headers