Grok Video 6s/10s/12s 视频生成

xAI Grok 新一代视频模型，异步生成接口。文生视频 / 首帧生视频 / 多参考图生视频共用同一端点，由 input_reference[] 数量区分调用模式。

调用流程为三步：① POST /v1/videos 提交任务；② GET /v1/videos/{task_id} 轮询直到 status=completed；③ GET /v1/videos/{task_id}/content 下载 mp4 文件。本系列在轮询响应中不返回 url 字段，视频内容必须通过 /content 端点获取。

接入地址

线路	Base URL
国内加速（推荐）	`https://cdn.wusag.com`
海外直连	`https://api.xinliu.one`

可用模型

model	时长
`grok-video-6s`	6 秒
`grok-video-10s`	10 秒
`grok-video-12s`	12 秒

实际生成时长由 seconds 字段决定（不传时按 model 名对应 6/10/12 秒）。提交时返回的 model 字段是统一别名 grok-imagine-video，调 GET /v1/videos/{task_id} 轮询时返回的才是真实 model 名（grok-video-6s / -10s / -12s）。

请求

方法：POST {Base URL}/v1/videos

Content-Type：multipart/form-data

Header：Authorization: Bearer 你的令牌

表单字段

字段	类型	必填	说明
`model`	string	是	`grok-video-6s` / `grok-video-10s` / `grok-video-12s`
`prompt`	string	是	提示词。多参考图模式可用 `@图1` `@图2` 占位指代上传顺序
`seconds`	string	否	`6` / `10` / `12`。漏填按 model 默认。接口不强制 seconds 跟 model 一致
`size`	string	否	五选一，见下表。漏填默认 `720x1280`
`resolution_name`	string	否	目前固定 `720p`，漏填可接受
`input_reference[]`	file	否	参考图数组。0 / 1 / 2~7 张分别对应文生 / 首帧 / 多参

size 可选值

size	用途
`720x1280`	竖版（默认）
`1280x720`	横版
`1024x1024`	方版
`1024x1792`	高竖版
`1792x1024`	宽横版

传其他尺寸返回 400，错误体明示上述 5 个为合法值。

调用模式

模式	input_reference 数量	prompt 用法
文生视频	0	纯文本描述
首帧生视频	1	纯文本描述，参考图作为视频起始帧
多参考图生视频	2~7	用 `@图1` `@图2` … 引用，按上传顺序对应

文生视频示例

首帧生视频示例

用图片 URL 作为参考图（仅限单张首帧场景）

URL 模式仅适用于单张参考图（首帧生视频），用单值字段名 input_reference（不带 []）传入。字段值可以是公网 HTTPS URL 或 data:image/...;base64,... Data URI，不要加 @ 前缀。

不能走 URL 的场景：数组语法 input_reference[] 仅接受 multipart 文件上传（返回 400 Expected UploadFile），仅 @/path/to/file.jpg 二进制上传才生效。多参考图场景（2~7 张）请使用「多参考图生视频示例」中的本地文件上传写法。

本接口不接受 application/json body，使用 JSON 提交会返回 400。

多参考图生视频示例（@图N 引用）

注意：prompt 以 @ 开头时不能用 curl -F，会被 curl 当作文件路径解析返回 (26) Failed to open/read local data。需要改用 --form-string：

提交后立即返回（HTTP 200）

{
  "id": "task_uh3B5YC4DurIkKMtzq4fkc5hr99Vp9po",
  "task_id": "task_uh3B5YC4DurIkKMtzq4fkc5hr99Vp9po",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1778141892,
  "seconds": "6",
  "size": "1280x720"
}

seconds 和 size 是字符串类型，不是数字。model 字段在提交响应中固定为别名 grok-imagine-video，轮询响应中才返回真实 model 名（grok-video-6s / -10s / -12s）。

第二步：轮询任务状态

提交后约 30~~120 秒进入 completed。建议首次 5 秒后查询，后续每 5~~10 秒查一次。

完成态响应（不含 url 字段，必须走第三步下载视频）：

{
  "id": "task_uh3B5YC4DurIkKMtzq4fkc5hr99Vp9po",
  "size": "1280x720",
  "model": "grok-video-6s",
  "object": "video",
  "prompt": "雪山日出航拍 缓慢推进 电影感",
  "status": "completed",
  "quality": "standard",
  "seconds": "6",
  "progress": 100,
  "created_at": 1778141892,
  "completed_at": 1778141950
}

第三步：下载视频文件

任务完成后调用 /content 端点直接获取 mp4 二进制流。响应头 Content-Type: video/mp4，Content-Disposition: attachment; filename="video_<32hex>.mp4"。文件保留 1~24 小时。

Python 示例：

错误码

HTTP	错误体	触发场景
400	`{"code":"missing_prompt","message":"prompt field is required","data":null}`	漏填 prompt
400	`{"code":"do_response_failed","message":"upstream error: …Input should be '720x1280', '1280x720', '1024x1024', '1024x1792' or '1792x1024'…"}`	size 不在 5 选一内
401	`{"error":{"message":"未提供令牌 ...","type":"new_api_error"}}`	漏 / 错 Authorization
503	`{"error":{"message":"分组 default 下模型 X 无可用渠道（distributor） ...","type":"new_api_error"}}`	model 不存在或漏填

Grok Video 6s/10s/12s 视频生成