Grok 视频
Grok 视频系列目前提供两套接入方式：OpenAI 兼容的/v1/videos（以 multipart/form-data 为主），以及统一视频的 /v1/video/* 与 /v1/video/query（JSON）。
OpenAI 格式
使用POST /v1/videos 提交、GET /v1/videos/{task_id} 查询，并支持 remix、extend、extensions 等衍生能力。
Grok 视频生成
POST /v1/videos，multipart 提交 Grok 视频任务。视频Remix
POST /v1/videos/{video_id}/remix，基于原任务做 remix。视频Extend
POST /v1/videos/{video_id}/extend，从指定时间点延展视频。视频Extensions
POST /v1/videos/extensions，通过 video.url 引用原任务做扩展。Grok 任务查询
GET /v1/videos/{task_id}，OpenAI 风格 video 对象查询。支持模型（OpenAI 格式）
| 模型 | 说明 | 时长规则 |
|---|---|---|
grok-video-3 | 基础版，支持文生、首帧、首尾帧、参考生视频 | 按请求传入 |
grok-video-3-pro | Pro 版 | 固定 10s |
grok-video-3-max | Max 版 | 固定 15s |
统一视频
使用POST /v1/video/create 创建任务，并支持 POST /v1/video/remix、POST /v1/video/extend、POST /v1/videos/extensions 等衍生能力；查询使用 GET /v1/video/query?id=。
创建视频
POST /v1/video/create，统一视频格式提交 Grok 任务。视频Remix
POST /v1/video/remix，Body 传 task_id。视频Extend
POST /v1/video/extend，Body 传 task_id 与 start_time。视频Extensions
POST /v1/videos/extensions，Body video.url 为原任务 ID。查询任务
GET /v1/video/query，按任务 id 查询状态与结果。常见能力（统一视频）
| 能力 | 传参方式 | 说明 |
|---|---|---|
| 文生视频 | images: [] | 仅文本提示 |
| 首尾帧 | images 按顺序 2 张 | 首帧 + 尾帧 |
| 多图参考 | images 多张 + @imgN | 在 prompt 中引用对应图片 |
对比
| 项目 | OpenAI 格式 | 统一视频 |
|---|---|---|
| 创建 | POST /v1/videos | POST /v1/video/create |
| Remix | POST /v1/videos/{video_id}/remix | POST /v1/video/remix（task_id） |
| Extend | POST /v1/videos/{video_id}/extend | POST /v1/video/extend（task_id） |
| Extensions | POST /v1/videos/extensions | POST /v1/videos/extensions（video.url） |
| 查询 | GET /v1/videos/{task_id} | GET /v1/video/query?id= |
| 请求格式 | multipart/form-data | JSON |
| 参考图 | input_reference | images |
| 画幅 | aspect_ratio | aspect_ratio |
| 分辨率 | size（720P / 1080P） | size（720P / 1080P） |
| 时长 | seconds | duration（默认 10，支持 6/10/15） |
参数约束（两套通用）
| 字段 | 可用值 | 说明 |
|---|---|---|
aspect_ratio | 16:9、9:16、2:3、3:2、1:1 | 统一视频文档化全量比例；OpenAI 格式当前常用 2:3、3:2、1:1 |
size | 720P、1080P | 分辨率规格 |