Grok Video 3 视频生成

xAI Grok Video 3 系列：

grok-video-3 固定 6 秒

grok-video-3-max 固定 10 秒

时长由模型固定，不可调节。本系列不支持视频延长。需要更长时长请使用 Veo 系列。

接入地址

线路	Base URL	说明
国内加速（推荐）	`https://cdn.wusag.com`	走国内 CDN 节点
海外直连	`https://api.xinliu.one`	海外服务器或加速节点异常时使用

两个地址共用同一账户和 Key。

请求

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

Header：

Authorization: Bearer 你的令牌

Content-Type: multipart/form-data

表单字段

字段	类型	必填	说明
`model`	string	是	`grok-video-3`（6s）或 `grok-video-3-max`（10s）
`prompt`	string	是	文本提示词
`size`	string	必填	档位三选一：`480P` / `720P` / `1080P`。注意 `grok-video-3-max` 不接受 `480P`。仅控制清晰度，不控制横竖屏方向
`aspect_ratio`	string	否	`16:9`（横屏）/ `9:16`（竖屏）/ `1:1`（方形）。横竖屏完全靠此字段控制。老格式 `3:2` / `2:3` 自动映射到 `16:9` / `9:16`
`input_reference`	file	否	参考图，支持本地文件 / URL / Base64。本系列无独立首帧/尾帧字段，所有图都通过 `input_reference` 上传

横竖屏控制

size 只控制清晰度（480P / 720P / 1080P），横竖屏方向完全由 aspect_ratio 决定：

方向	size	aspect_ratio	示例输出
横屏	`720P` 或 `1080P`	`16:9`（不传默认）	688x464 / 1280x720 等
竖屏	`720P` 或 `1080P`	`9:16`（必传）	464x688 / 720x1280 等
方形	`720P` 或 `1080P`	`1:1`	720x720 / 1080x1080

具体像素值（如 480x720）会被自动识别为档位（含 720 → 720P），方向不会由像素值决定。

老格式 3:2 / 2:3 自动映射到 16:9 / 9:16（兼容历史调用）。

文生视频示例

图生视频示例

多图参考示例

多张参考图通过同字段名 input_reference 重复上传，顺序按 -F 参数从前到后。

参考图说明

所有参考图都通过 input_reference 字段上传，本系列没有独立的「首帧」/「尾帧」字段

模型将参考图作为视觉参考，第一帧画面通常接近参考图，但不做严格首帧锚定

需要严格首尾帧锚定请使用 Veo -fl 系列

立即返回 task_id，调 GET /v1/videos/{task_id} 轮询。

提交后立即返回

{
  "id": "task_uZkx29iZ9fJfyQUo9s7RecqknNxCTTlv",
  "task_id": "task_uZkx29iZ9fJfyQUo9s7RecqknNxCTTlv",
  "object": "video.generation",
  "status": "processing",
  "progress": 0,
  "created_at": 1778069154
}

错误码

400 参数错误（如 size 不被模型支持、参考图链接不可达）

401 令牌无效

402 余额不足（按预估费用预扣）

404 模型不存在或未开通

429 同时进行任务数超上限

500 服务端错误

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Grok Video 3 视频生成