跳转到主要内容
GET
查询任务

查询任务

Grok 统一视频任务提交后,通过 GET /v1/video/query 查询进度与结果。查询参数使用 id,值为 创建视频 返回的任务 ID。
  • 路由入口是 GET /v1/video/query
  • 任务 ID 通过 Query 参数 id 传入,格式常为 grok:...
  • 完成后 video_url 会带上可访问地址;处理中可能为 null

方法与路径

请求示例

响应示例

部分渠道还会返回 asset_idvideo_file_idtrace_id 等扩展字段,请以实际响应为准。

认证

Query Parameters

id
string
必填
任务 ID,与创建接口返回的 id 一致。

Response

id
string
任务 ID。
status
string
任务状态,常见值包括 processingcompletedfailedunknown
video_url
string | null
视频结果地址。任务未完成时可能为 null
status_update_time
integer
状态最近更新时间(Unix 时间戳)。
progress
integer
任务进度百分比,部分响应包含。
prompt
string
提交时的提示词回显。
ratio
string
视频比例回显,例如 3:2
thumbnail_url
string
缩略图地址,完成后可能出现。

相关接口