POST

可用范围

使用已开通异步图片能力的分组。若返回 async image tasks are not enabled,可改用同步图片接口。

处理流程

  1. 提交与同步生成一致的图片参数,不要设置 stream: true。
  2. 读取 HTTP 202、任务标识和 poll_url;也可读取 Location 响应头。
  3. 使用创建任务的同一把 Key 查询。若有 Retry-After,按其建议间隔轮询。
  4. 任务完成后读取结果并保存;失败时保留任务 ID 与错误信息。
异步编辑对应 POST /v1/images/edits/async,同样需要分组及模型支持。

任务结果与退款

使用提交响应中的 poll_url 获取任务状态与结果。响应含有效期或退款信息时,可一并读取;费用明细可在使用记录查看。 查询超时后继续查询原任务。任务失败时查看错误信息;退款处理中请等待入账,再核对最终费用。
查询和下载使用创建任务的同一把 API Key。任务结束前请保留密钥及其分组绑定。