Grok 视频生成
Grok 通过 OpenAI 格式入口提交异步视频任务，使用 multipart/form-data 组织请求。
http
POST /v1/videos任务提交为异步：创建成功后用返回的任务 ID 轮询状态与结果。
input_reference是参考图字段，支持重复上传多张图片。grok-video-3-pro会自动固定为10秒，grok-video-3-max会自动固定为15秒。- 基础版
grok-video-3没有固定秒数逻辑，按实际传参处理。
当前可用模型
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token，示例： |
本接口以
multipart/form-data提交（curl 使用-F时 Content-Type 由客户端自动携带），无需手动设置。
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称 | |
| string | 是 | 提示词，描述要生成的视频内容 | |
| string | 否 | 视频比例：、、、、 | |
| integer | 否 | 目标秒数。 / 会被自动纠正为固定值 | |
| string | 否 | 分辨率档位，常用 或 | |
| file | 否 | 参考图文件，可重复传多次对应多张参考图 |
请求示例
bash
curl -X POST https://octopusx.ai/v1/videos \
-H "Authorization: Bearer <token>" \
-F "model=grok-video-3" \
-F "prompt=猫咪听歌摇头晃脑，下大雨" \
-F "aspect_ratio=2:3" \
-F "seconds=6" \
-F "size=720P" \
-F "[email protected]"使用场景
| 场景 | 字段要点 |
|---|---|
| 文生视频 | + + + |
| 图生视频 | 文生视频基础上追加一个或多个 |
| 固定时长模型 | / 按服务端固定秒数处理 |
响应示例
json
{
"id": "video_abc123",
"object": "video",
"model": "grok-video-3",
"status": "queued",
"progress": 0,
"created_at": 1735689600,
"size": "720P"
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 任务 ID，后续轮询使用 | |
| string | 固定为 | |
| string | 实际提交的模型名 | |
| string | 任务状态：、、、、 | |
| integer | 进度百分比 | |
| integer | 创建时间戳 | |
| string | 输出清晰度档位 |
其它格式与模式
Remix（/v1/videos/{video_id}/remix）
基于已有 Grok 视频任务生成变体。路径参数 为原任务 ID，请求体为 JSON。
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称 | |
| string | 是 | 改写或延续原视频内容的提示词 | |
| string | 是 | 或 | |
| string | 是 | 、、 |
Extend（/v1/videos/{video_id}/extend）
基于已有任务从指定时间点延展视频。必填 与 ；可选 （从原视频第几秒开始）与 （补充参考图）。
Extensions（/v1/videos/extensions）
对已有任务的指定片段做扩展。必填 、、、； 填原视频任务 ID（例如 ）。