​
异步任务查询

图片和视频等异步模型在提交成功后，会先返回任务 ID。 调用方应保存 task_id，并按模型类型使用对应的查询接口轮询结果。

​
图片任务查询接口

适用范围：
  1. 图片异步模型
  2. 其他走统一任务中心的异步能力
图片任务查询时，对外以以下字段为准：
  1. task_id
  2. status
  3. progress
  4. result_url
  5. fail_reason
图片任务查询成功示例：
图片任务查询失败示例：
补充说明：
  1. 图片任务查询返回的 result_url 始终表示平台可直接使用的稳定结果地址。
  2. 文档站只描述正式对外字段，不描述历史兼容字段。
  3. 即使旧版响应中暂时保留了额外字段，新接入方也不应依赖这些兼容字段。

​
视频任务查询接口

适用范围：
  1. grok-imagine-video-1.0
  2. grok-imagine-video-1.5
  3. gemini-omni-flash
  4. veo-3.1
  5. veo-3.1-fast
  6. seedance-2.0
  7. seedance-2.0-fast
  8. happyhorse-1.0
  9. gemini-omni-flash-ext
视频任务查询时，对外以以下字段为准：
  1. id 或 task_id
  2. status
  3. progress
  4. result_url
  5. fail_reason
视频任务查询成功示例：
视频任务查询失败示例：
补充说明：
  1. gemini-omni-flash 的 default / standard 两组都统一走 GET /v1/videos/{task_id} 查询结果。
  2. 当前所有视频逻辑模型统一使用同一个查询接口，不需要按模型实现差异区分轮询地址。
  3. 视频任务查询成功时，统一从顶层 result_url 读取结果地址。
  4. 旧版响应中可能还会出现 metadata.url 与 error.message，但新接入方不应依赖这些兼容字段。

​
典型流程

  1. 调用生成接口
  2. 获取任务 ID
  3. 根据模型类型选择对应查询接口
  4. 任务成功后读取统一结果地址

​
常见状态

​
图片任务

  1. submitted
  2. processing
  3. succeeded
  4. failed

​
视频任务

  1. queued
  2. in_progress
  3. completed
  4. failed

​
轮询建议

  1. 首次查询建议在提交后数秒开始。
  2. 轮询间隔建议控制在 2 到 5 秒。
  3. 任务结束后停止轮询，避免无效请求。