Skip to main content
POST
使用 gpt-image-2.5-async 提交异步图像生成任务。接口会立即返回任务 ID,适合不希望长时间保持 HTTP 连接的场景。

提交任务

参数

string
required
Bearer Token,例如 Authorization: Bearer YOUR_API_KEY。
string
default:"application/json"
required
固定使用 application/json。
string
default:"gpt-image-2.5-async"
required
固定填写 gpt-image-2.5-async。
string
required
图片内容描述。
string
default:"1024x1024"
输出尺寸。可用值见下方的支持尺寸。
string
default:"auto"
图片质量,可选 auto、low、medium 或 high。

响应

保存响应中的 id,然后按照任务查询页面轮询任务状态和结果。

支持尺寸

轮询建议

  • 每 3 到 5 秒查询一次,最长等待 10 分钟。
  • 任务状态为 completed 后读取结果 URL。
  • failed 或 cancelled 时停止轮询,并读取错误信息。
  • 停止轮询不会取消服务端任务。