mingyanmingyan
mingyan

Grok - 查询任务

查询 Grok 视频生成任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

Grok 查询视频任务

使用任务 ID 查询 Grok 视频生成任务的状态和结果。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

idstring必填
视频生成任务的唯一标识符,从创建任务接口返回。
创建接口直接返回字段 id,查询时请将该值作为这里的 id 使用。

响应参数

idstring
视频生成任务的唯一标识符。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
使用的模型名称,例如 grok_video3grok_video3_progrok_video3_maxgrok_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 在长时长或多参考图场景下,通常会比基础场景更慢
  • 当状态为 completedfailed 时停止轮询

结果说明

重要提示:
  • 生成结果通常为临时下载地址,请及时保存
  • 参考图较多、时长较长时,处理时间通常更久
  • 如提示词或参考图不符合要求,任务可能返回失败状态