Grok Imagine Video 1.5 视频生成

面向高想象力视频创意扩展与概念镜头生成
提交成功后返回视频任务 ID
对外只区分 default、standard 两组能力
default 组 duration 支持 6、10、12、15 秒
default 组支持 16:9、9:16
default 组必须且只能传 1 张参考图
standard 组当前正式开放 6、10、12、15 秒
standard 组额外支持 1:1、3:2、2:3
resolution 支持 480p、720p
standard 组支持文生视频或图生视频，参考图最多 7 张

请求鉴权

所有接口均需要使用 Bearer Token 进行认证。

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/videos

提交视频异步任务。接口受理成功后会立即返回视频任务 ID，实际视频结果需要通过查询接口继续轮询。对外统一只传逻辑模型名 grok-imagine-video-1.5，平台会按当前分组应用对应参数边界。

请求参数

字段	类型	必填	默认值	说明
`model`	`string`	是	-	固定传 `grok-imagine-video-1.5`
`prompt`	`string`	是	-	视频生成提示词
`n`	`number`	否	`1`	当前仅支持传 `1`
`images`	`string[]`	按分组	-	`default` 必须且只能传 `1` 张；`standard` 可不传，最多传 `7` 张
`duration`	`number`	否	`6`	当前平台正式开放 `6/10/12/15`
`aspect_ratio`	`string`	否	`按分组能力处理`	`default` 组支持 `16:9`、`9:16`，未传时默认按 `9:16`；`standard` 组额外支持 `1:1`、`3:2`、`2:3`
`resolution`	`string`	否	`480p`	清晰度档位，支持 `480p`、`720p`

分组参数说明

以下只列不同分组之间存在差异的字段：

差异项	`default` 组	`standard` 组
生成形态	仅支持单参考图图生视频	支持文生视频或图生视频
`images`	必须且只能 `1` 张参考图	可不传；图生时最多 `7` 张，且只接受公网 `http/https` 图片地址
`aspect_ratio`	支持 `16:9 / 9:16`，未传时默认按 `9:16`	支持 `16:9 / 9:16 / 1:1 / 3:2 / 2:3`

响应

提交成功响应示例：

{
  "id": "video_task_01KQEXAMPLE_GROK15",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1711111111
}

提交失败响应示例：

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "参数错误，请检查 prompt、images、duration、aspect_ratio 或 resolution 是否符合当前模型要求"
  }
}

任务查询接口

GET /v1/videos/{task_id}

查询成功示例：

{
  "id": "video_task_01KQEXAMPLE_GROK15",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "duration": 10,
    "width": 1280,
    "height": 720
  },
  "url": "https://example.com/result/grok-video-15.mp4"
}

使用示例

文生视频

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video-1.5",
    "prompt": "生成一段未来城市夜景中的镜头移动短片，霓虹反光明显，画面有层次",
    "n": 1,
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

说明：

当前只有 standard 组支持文生视频。
时长仍按当前平台正式开放的 6/10/12/15 四档传参。

图生视频

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video-1.5",
    "prompt": "保留角色造型和主色调，生成一段镜头缓慢推进的展示短片",
    "n": 1,
    "images": [
      "https://example.com/reference-1.jpg"
    ],
    "duration": 12,
    "aspect_ratio": "9:16",
    "resolution": "720p"
  }'

说明：

default 组图生时必须且只能传 1 张参考图。
standard 组图生时可传 1-7 张参考图。
若未传 aspect_ratio，default 组当前默认按 9:16。

多参考图图生视频

curl --request POST \
  --url https://your-domain/v1/videos \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video-1.5",
    "prompt": "融合多张商品设定图，生成一段方形构图的展示短片，镜头缓慢推进",
    "n": 1,
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg",
      "https://example.com/reference-3.jpg"
    ],
    "duration": 12,
    "aspect_ratio": "1:1",
    "resolution": "480p"
  }'

说明：

多参考图图生当前只适用于 standard 组。
default 组若传 2 张或更多参考图会被拒绝。

注意事项

default 组不能不传图，也不能传 2 张或更多参考图。
standard 组当前支持更灵活的图片数与比例，但时长仍按当前平台正式开放的 6/10/12/15 四档传参。
建议优先使用 duration=6/10/12 与 resolution=720p 作为稳定组合。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

开始使用

文本系列

图像系列

视频系列

音频系列

Grok Imagine Video 1.5

Grok Imagine Video 1.5 视频生成

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

图生视频

多参考图图生视频

注意事项

​Grok Imagine Video 1.5 视频生成

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​文生视频

​图生视频

​多参考图图生视频

​注意事项

Grok Imagine Video 1.5 视频生成

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

图生视频

多参考图图生视频

注意事项