Grok Imagine Video 1.5

模型名称：grok-imagine-video-1.5

面向高想象力视频创意扩展与概念镜头生成
提交成功后返回视频任务 ID
对外只区分 default、standard 两组能力
分组由 Bearer Token 所属分组决定，不通过模型名后缀选择
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，平台会根据当前 Bearer Token 所属分组应用对应参数边界。不要传 grok-imagine-video-1.5-standard 等带分组后缀的模型名。

请求参数

字段	类型	必填	默认值	说明
`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`	否	`按分组能力处理`	可选值和默认行为见下方分组表
`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
  },
  "result_url": "https://example.com/result/grok-video-15.mp4"
}

使用示例

文生视频

curl --request POST \
  --url https://api.aimaxa.cn/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://api.aimaxa.cn/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://api.aimaxa.cn/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 四档传参。
模型名始终传 grok-imagine-video-1.5；default/standard 由 Token 分组决定，不要使用 grok-imagine-video-1.5-standard。
建议优先使用 duration=6/10/12 与 resolution=720p 作为稳定组合。
提交成功后请使用 GET /v1/videos/{task_id} 继续轮询结果。

常见错误

请求问题	原因与处理
`default` 未传 `images`	`default` 仅支持单图图生视频，必须传且只能传 `1` 张参考图
`default` 传多张图	删除多余图片，只保留 `1` 张；多参考图请使用所属分组为 `standard` 的 Token
`duration` 传 `5` 或 `7`	当前只支持 `6/10/12/15`，请改为其中一个合法值
模型名传 `grok-imagine-video-1.5-standard`	模型名错误；改为 `grok-imagine-video-1.5`，分组由 Token 决定

异步状态与失败响应

视频任务状态只使用 queued、in_progress、completed、failed。处于 queued 或 in_progress 时继续调用查询接口；只有 completed 状态才读取顶层 result_url。任务失败时保持视频对象结构，并返回顶层 error 与 fail_reason，不要按图片接口读取 code/data/works：

{
  "id": "video_task_01KQEXAMPLE_FAILED",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "task_failed",
    "message": "请求处理失败，请稍后重试"
  },
  "fail_reason": "请求处理失败，请稍后重试"
}

开始使用

图像模型

视频模型

文本模型

Grok Imagine Video 1.5

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

图生视频

多参考图图生视频

注意事项

常见错误

异步状态与失败响应

​请求鉴权

​提交任务接口

​请求参数

​分组参数说明

​响应

​任务查询接口

​使用示例

​文生视频

​图生视频

​多参考图图生视频

​注意事项

​常见错误

​异步状态与失败响应

请求鉴权

提交任务接口

请求参数

分组参数说明

响应

任务查询接口

使用示例

文生视频

图生视频

多参考图图生视频

注意事项

常见错误

异步状态与失败响应