Skip to main content
GET
获取 Grok 视频任务状态

任务状态说明

轮询建议

Grok 视频任务通常在数十秒到数分钟内完成,具体取决于分辨率与时长 (720p 比 480p 更慢)。建议每 5–10 秒轮询一次,并设置合理超时时间。

获取视频

完成后有两种方式获取视频:
  • 直接使用 metadata.url 中的链接(有效期见 expires_at,请尽快下载)
  • 调用 GET /v1/videos/{task_id}/content 通过接口代理下载

授权

Authorization
string
header
必填

使用 Bearer Token 认证,格式:Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

路径参数

task_id
string
必填

视频任务 ID,由创建接口返回的 id 字段。

响应

成功获取视频任务状态

Grok 视频任务对象,兼容 OpenAI / Sora 视频任务格式。

id
string
必填

视频任务 ID。

示例:

"video_abc123"

object
enum<string>
必填

对象类型,固定为 video

可用选项:
video
示例:

"video"

model
enum<string>
必填

执行任务所用的模型。

可用选项:
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"

status
enum<string>
必填

任务状态。

可用选项:
queued,
in_progress,
completed,
failed
示例:

"queued"

progress
integer
必填

任务进度百分比(0–100)。

必填范围: 0 <= x <= 100
示例:

0

created_at
integer<int64>
必填

任务创建时间戳(毫秒)。

示例:

1764347090922

seconds
string
必填

视频时长,单位秒。

示例:

"10"

completed_at
integer<int64>

任务完成时间戳(毫秒),完成后填充。

示例:

1764347170000

expires_at
integer<int64>

任务及视频文件的过期时间戳(毫秒)。

示例:

1764433570000

size
string

实际输出尺寸,格式如 1280x720。 实际分辨率由模型名后缀决定,画幅比例由请求的 size 决定。

示例:

"1280x720"

error
object

Grok 视频任务错误信息。

metadata
object

额外元数据,任务完成后通常包含 url 字段。