获取 Grok 视频任务状态
Grok Imagine 视频
获取 Grok 视频任务状态
轮询 Grok 视频任务,获取进度和最终视频 URL
GET
获取 Grok 视频任务状态
任务状态说明
轮询建议
Grok 视频任务通常在数十秒到数分钟内完成,具体取决于分辨率与时长 (720p 比 480p 更慢)。建议每 5–10 秒轮询一次,并设置合理超时时间。获取视频
完成后有两种方式获取视频:- 直接使用
metadata.url中的链接(有效期见expires_at,请尽快下载) - 调用
GET /v1/videos/{task_id}/content通过接口代理下载
授权
路径参数
视频任务 ID,由创建接口返回的 id 字段。
响应
成功获取视频任务状态
Grok 视频任务对象,兼容 OpenAI / Sora 视频任务格式。
视频任务 ID。
示例:
"video_abc123"
对象类型,固定为 video。
可用选项:
video 示例:
"video"
执行任务所用的模型。
可用选项:
grok-imagine-video-480p, grok-imagine-video-720p, grok-imagine-video-1.5-preview-480p, grok-imagine-video-1.5-preview-720p 示例:
"grok-imagine-video-720p"
任务状态。
可用选项:
queued, in_progress, completed, failed 示例:
"queued"
任务进度百分比(0–100)。
必填范围:
0 <= x <= 100示例:
0
任务创建时间戳(毫秒)。
示例:
1764347090922
视频时长,单位秒。
示例:
"10"
任务完成时间戳(毫秒),完成后填充。
示例:
1764347170000
任务及视频文件的过期时间戳(毫秒)。
示例:
1764433570000
实际输出尺寸,格式如 1280x720。
实际分辨率由模型名后缀决定,画幅比例由请求的 size 决定。
示例:
"1280x720"
Grok 视频任务错误信息。
额外元数据,任务完成后通常包含 url 字段。