Skip to main content
GET

图像异步任务查询

/v1/images/generations/async/{taskId} 用于查询图像异步生成任务。提交任务后保存返回的 idtask_idtaskId,再通过这个接口轮询任务状态。
  • 查询路径为 GET /v1/images/generations/async/{taskId}
  • 这个接口只查询已有任务,不会重新提交生图请求。
  • 任务未完成时重点读取 statusprogress,其中 progress 在当前通道里常见为字符串百分比。
  • 任务完成后返回结果对象,从 data[].urldata[].b64_json 读取图片结果。
  • 任务失败时读取 error.messageerror.code 定位原因。

方法与路径

请求示例

响应示例

认证

Path Parameters

taskId
string
required
异步生图任务 ID。使用 POST /v1/images/generations/async 返回的 idtask_idtaskId

Response

id
string
任务 ID。
task_id
string
任务 ID 的兼容字段。
object
string
对象类型,通常为 image.generation.task
model
string
任务使用的图像模型,例如 gpt-image-2gpt-image-2-vipdoubao-seedream-4-0-250828gemini-3-pro-image-previewgemini-3.1-flash-lite-image
status
string
任务状态。常见值包括 queuedprocessingin_progresscompletedsucceededfailedcancelled
progress
string
任务进度百分比。当前通道实测常见格式为字符串百分比,例如 10%
created_at
integer
任务创建时间戳。
size
string
输出尺寸,例如 1024x10241536x10243840x21603808x1632
data[].url
string
任务完成后返回的图片 URL。
data[].b64_json
string
任务完成后返回的图片 Base64 数据。
data[].revised_prompt
string
上游改写后的提示词。是否返回取决于实际模型和通道。
error
object
失败原因对象。任务失败时读取 error.messageerror.code

状态处理

轮询建议

  • 创建任务后先等待 25 秒再开始查询。
  • 常规轮询间隔建议为 35 秒;长任务可以逐步退避到 10 秒。
  • 业务侧应设置最大等待时间,避免无限轮询。
  • 同一个 taskId 可以重复查询,查询本身不会重新消耗一次生图任务。

相关页面