创建 Grok 视频任务（生成 / 编辑）

创建 Grok 视频任务，支持文生视频、单首帧图生视频、多参考图视频和视频局部编辑。

模型差异与选择建议

对比项	`grok-imagine-video-1.5`	`grok-imagine-video-edit`
适合场景	新建视频；支持文生、单首帧图生、多参考图	修改已有视频中的指定元素
Content-Type	`application/json`	公网 URL / data URL 用 `application/json`；本地文件用 `multipart/form-data`
必填核心字段	`model`、`prompt`；建议传 `seconds`，并传 `size` 或 `aspect_ratio`	`model`、`prompt`、`video`
时长	文生/单图最长 `15` 秒；多参考图最长 `10` 秒	源视频最长 `8.7` 秒
画幅	`720x1280`、`1280x720`、`1024x1792`、`1792x1024`；更多比例用 `aspect_ratio`	跟随源视频
参考图/源视频	单图 `input_reference`；多图 `reference_images`，最多 7 张	`video.url` 支持公网 URL 或 data URL；multipart 支持 `video=@source.mp4`

调用模式参数速查

模式	Content-Type	必填参数	可选参数	关键限制	对应示例
文生视频	`application/json`	`model`、`prompt`	`seconds`、`size`、`aspect_ratio`、`resolution`	`seconds` 必须是字符串；文生最长 15 秒；`resolution` 支持 `480p/720p`	见「文生视频」
单首帧图生视频	`application/json`	`model`、`prompt`、`input_reference`	`seconds`、`size`、`aspect_ratio`、`resolution`	`input_reference` 传公网 URL 或 data URL；本地图片需转 data URL 或先上传公网；最长 15 秒	见「单首帧图生视频」
多参考图视频	`application/json`	`model`、`prompt`、`reference_images`	`seconds`、`size`、`aspect_ratio`、`resolution`	`reference_images` 最多 7 张；最长 10 秒；不能同时传 `input_reference`	见「多参考图视频」
视频编辑（公网 URL）	`application/json`	`model`、`prompt`、`video.url`	无	源视频 `<=8.7s`、`<=25MB`、H.264 MP4；输出跟随源视频	见「视频编辑（公网 URL）」
视频编辑（base64 data URL）	`application/json`	`model`、`prompt`、`video.url`	无	`video.url` 使用 `data:video/mp4;base64,...`；平台自动临时转存，约 2h 清理	见「视频编辑（data URL）」
视频编辑（multipart 文件）	`multipart/form-data`	`model`、`prompt`、`video`	无	`video=@source.mp4`；平台自动临时转存，约 2h 清理	见「视频编辑（multipart 文件）」

参数规则补充

seconds 必须传字符串，例如 "6"。

不支持 1080p。

不支持 size=960x960；方形视频请使用 aspect_ratio=1:1。

1024x1792/1792x1024 是等价画幅，实际输出仍为 720p 档，不是更高清。

图生视频只支持首帧参考图（input_reference）或多参考图（reference_images），不支持首尾帧。

单图 input_reference 与多图 reference_images 不可同时使用。

本地图片请转成 data URL 或先上传到公网 URL。

编辑模型只用于编辑已有视频，不需要传 seconds、size、aspect_ratio、resolution；这些生成参数不会控制编辑输出。

编辑源视频可通过公网 URL、data URL 或 multipart 文件上传提供；源视频需 <=8.7s、<=25MB、H.264 MP4。data URL / multipart 文件会由平台自动临时转存，约 2h 清理。

编辑按次计费，失败任务不计费。

2026-06-18 实测结果

使用 H.264 MP4 源视频（720x1280、6.042s、1.1MB）验证：公网 URL、data:video/mp4;base64,...、multipart video=@source.mp4 三种传法均创建成功并完成，输出均为 720x1280、6.042s。

视频编辑推荐流程

编辑模型 grok-imagine-video-edit 最推荐的用法是：先用 grok-imagine-video-1.5 出片，再把生成结果里的 video_url 作为编辑源传给编辑模型。

推荐流程：

调用 grok-imagine-video-1.5 创建视频任务。

轮询 GET /v1/videos/{task_id}，直到返回 status=completed。

取完成响应里的 video_url。

调用 grok-imagine-video-edit，将上一步的 video_url 放到 video.url，或将本地源视频转为 data URL / multipart 文件上传。

再轮询编辑任务，完成后获取新的 video_url。

可复制 curl 示例

只需要把 sk-xxx 替换为你的 API Key。

文生视频（JSON）

单首帧图生视频（JSON）

单首帧本地图片（data URL）

多参考图视频（JSON）

生成视频后再编辑（JSON）

视频编辑（JSON）

视频编辑（base64 data URL）

视频编辑（multipart 文件上传）

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "model": "grok-imagine-video-1.5",
    "prompt": "A clean product video of a white cube rotating slowly on a neutral studio background.",
    "seconds": "6",
    "aspect_ratio": "4:3",
    "resolution": "720p"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

创建 Grok 视频任务（生成 / 编辑）

模型差异与选择建议#

调用模式参数速查#

参数规则补充#

2026-06-18 实测结果#

视频编辑推荐流程#

可复制 curl 示例#

文生视频（JSON）#

单首帧图生视频（JSON）#

单首帧本地图片（data URL）#

多参考图视频（JSON）#

生成视频后再编辑（JSON）#

视频编辑（JSON）#

视频编辑（base64 data URL）#

视频编辑（multipart 文件上传）#