Grok 视频
Grok 视频系列主要围绕POST /v1/videos 和 GET /v1/videos/{task_id} 这一组接口展开。
- 请求方式以
multipart/form-data为准。 - 参考图统一通过
input_reference传入，支持单张或多张。 - 常用字段是
model、prompt、aspect_ratio、seconds、size。
视频生成
POST /v1/videos，提交 Grok 视频生成任务。任务查询
GET /v1/videos/{task_id}，查询任务状态并获取结果地址。支持模型
| 模型 | 说明 | 时长规则 |
|---|---|---|
grok-video-3 | 基础版，支持文生视频、首帧生视频、首尾帧、参考生视频 | 按请求传入 |
grok-video-3-pro | Pro 版 | 固定 10s |
grok-video-3-max | Max 版 | 固定 15s |
常见能力
| 能力 | 传参方式 | 说明 |
|---|---|---|
| 文生视频 | 仅传文本字段 | 最基础调用方式 |
| 首帧生视频 | input_reference 传 1 张图 | 可把首帧图或指定参考图作为第一张输入 |
| 首尾帧 | input_reference 传 2 张图 | 按顺序传入首帧、尾帧 |
| 参考生视频 | input_reference 传多张图 | 最多支持 6 张 |
参数约束
| 字段 | 可用值 | 说明 |
|---|---|---|
aspect_ratio | 2:3、3:2、1:1 | 当前按接口定义整理 |
size | 720P、1080P | 优先使用这组值 |
seconds | 整数 | 会自动纠正为固定秒数 |