图像异步生成
图像异步任务查询
使用 GET /v1/images/generations/async/{taskId} 查询图像异步生成任务状态、进度和结果。
GET
图像异步任务查询
/v1/images/generations/async/{taskId} 用于查询图像异步生成任务。提交任务后保存返回的 id、task_id 或 taskId,再通过这个接口轮询任务状态。
- 查询路径为
GET /v1/images/generations/async/{taskId}。 - 这个接口只查询已有任务,不会重新提交生图请求。
- 任务未完成时重点读取
status和progress,其中progress在当前通道里常见为字符串百分比。 - 任务完成后返回结果对象,从
data[].url或data[].b64_json读取图片结果。 - 任务失败时读取
error.message和error.code定位原因。
方法与路径
请求示例
响应示例
认证
Path Parameters
异步生图任务 ID。使用
POST /v1/images/generations/async 返回的 id、task_id 或 taskId。Response
任务 ID。
任务 ID 的兼容字段。
对象类型,通常为
image.generation.task。任务使用的图像模型,例如
gpt-image-2、gpt-image-2-vip、doubao-seedream-4-0-250828、gemini-3-pro-image-preview 或 gemini-3.1-flash-lite-image。任务状态。常见值包括
queued、processing、in_progress、completed、succeeded、failed、cancelled。任务进度百分比。当前通道实测常见格式为字符串百分比,例如
10%。任务创建时间戳。
输出尺寸,例如
1024x1024、1536x1024、3840x2160、3808x1632。任务完成后返回的图片 URL。
任务完成后返回的图片 Base64 数据。
上游改写后的提示词。是否返回取决于实际模型和通道。
失败原因对象。任务失败时读取
error.message 与 error.code。状态处理
轮询建议
- 创建任务后先等待
2到5秒再开始查询。 - 常规轮询间隔建议为
3到5秒;长任务可以逐步退避到10秒。 - 业务侧应设置最大等待时间,避免无限轮询。
- 同一个
taskId可以重复查询,查询本身不会重新消耗一次生图任务。