Skip to main content
GET
Grok 任务查询

Grok 任务查询

Grok Imagine 系列任务提交后,通过 GET /v1/videos/{task_id} 轮询状态,并共用同一组查询与下载接口。
  • 接口路径是 GET /v1/videos/{task_id}
  • 任务完成后,优先从响应中的视频 URL 字段读取结果地址。
  • 如果响应没有公开 URL,或直接下载公开 URL 失败,可回退到 GET /v1/videos/{task_id}/content
  • /content 端点需要携带同一个 Authorization: Bearer YOUR_API_KEY

方法与路径

请求示例

响应示例

认证

Path Parameters

task_id
string
required
视频任务 ID。

Response

id
string
任务 ID。
status
string
任务状态。常见值有 processingfailedcompleted
model
string
任务对应的模型名。该字段用于展示和排查,不应用作任务 ID。
progress
integer
进度百分比。
completed_at
integer
完成时间戳。
expires_at
integer
结果过期时间戳。
seconds
string
输出时长。
size
string
输出清晰度档位。
video_url
string
视频地址。完成时通常可直接下载;如果为空或不可下载,按下方兼容顺序读取其他字段,或回退到 /content
error
object
失败原因对象。

轮询建议

建议客户端将以下状态视为处理中并继续轮询:queuedpendingprocessingin_progressrunninggenerating 建议将以下状态视为完成:completedsucceededsuccess 建议将以下状态视为失败或终止:failedfailerrorcancelledcanceledexpireddeleted 任务完成后,结果地址可按以下兼容顺序读取:
  1. content.video_url
  2. content.url
  3. output.url
  4. video_url
  5. url
  6. detail.url
  7. data[0].url
如果这些字段都为空,或下载返回的地址失败,再回退请求:
下载 /content 时需要继续携带鉴权头:

相关接口