GlobalAiOpc
Grok - 查询任务
查询 Grok 视频生成任务的状态和结果
Grok 查询视频任务
使用任务 ID 查询 Grok 视频生成任务的状态和结果。
认证
认证
获取 Key所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。路径参数
idstring必填视频生成任务的唯一标识符,从创建任务接口返回。
创建接口直接返回字段
id,查询时请将该值作为这里的 id 使用。响应参数
idstring视频生成任务的唯一标识符。
objectstring对象类型,固定为
video。createdinteger任务创建时间戳。
modelstring使用的模型名称,例如
grok_video3、grok_video3_pro、grok_video3_max 或 grok_video3_stable。statusstring任务状态:
queued- 排队中processing- 处理中completed- 已完成failed- 失败
video_urlstring生成的视频 URL,当状态为
completed 时返回。actualDurationnumber视频实际输出时长(秒),当状态为
completed 时返回。errorstring错误信息,当状态为
failed 时返回。状态流程
queued
任务已创建并加入队列,等待处理。
processing
任务正在处理中,Grok 模型正在生成视频。
completed
任务完成,可通过
video_url 获取结果。轮询建议
轮询策略:
- 建议轮询间隔:30-60 秒
- 不同模型、视频时长和参考图数量会影响完成时间
grok_video3_max在长时长或多参考图场景下,通常会比基础场景更慢- 当状态为
completed或failed时停止轮询
结果说明
重要提示:
- 生成结果通常为临时下载地址,请及时保存
- 参考图较多、时长较长时,处理时间通常更久
- 如提示词或参考图不符合要求,任务可能返回失败状态
