跳转到主要内容
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "video_url": null,
  "error": null
}

​
Grok 查询视频任务

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

​
认证

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

​
路径参数

​
id
string
必填
视频生成任务的唯一标识符，从创建任务接口返回示例：video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

​
响应参数

​
id
string
视频生成任务的唯一标识符
​
object
string
对象类型，固定为 video
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称（grok_video3 或 grok_video3_pro）
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
​
video_url
string
生成的视频URL，当 status 为 completed 时返回
​
actualDuration
number
视频实际输出时长（秒），当 status 为 completed 时返回
​
error
string
错误信息，当 status 为 failed 时返回

​
状态流程

1

queued

任务已创建并加入队列，等待处理
2

processing

任务正在处理中，Grok 模型正在生成视频
3

completed

任务完成，视频生成成功，可通过 video_url 获取结果

​
轮询建议

轮询策略：
  • 建议轮询间隔：30-60 秒
  • Grok 生成速度因模型和时长而异：
    • grok_video3（6-10秒）：通常 2-4 分钟完成
    • grok_video3（20-30秒）：通常 4-8 分钟完成
    • grok_video3_pro（10秒）：通常 3-6 分钟完成
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completed 或 failed 时停止轮询

​
视频URL说明

重要提示：
  • 生成的视频URL有效期通常为 24 小时
  • 请及时下载并保存视频到你的存储系统
  • URL 过期后将无法访问视频
  • 视频文件通常为 MP4 格式

​
生成时间预估

Grok Video3

灵活时长（6-30秒）预计生成时间：2-8 分钟 （时长越长，生成时间越长）

Grok Video3 Pro

固定 10 秒，高质量预计生成时间：3-6 分钟
影响生成时间的因素：
  • 视频时长：时长越长，生成时间越长
  • 分辨率选择：720p 比 480p 需要更长时间
  • 参考图片数量：使用多张参考图片可能增加处理时间
  • 系统负载：高峰期可能需要更长的排队时间
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "video_url": null,
  "error": null
}