Grok Video 1.5

本页示例中的 {BASE_URL} 表示 https://api.uniall.ai。

更新时间：2026-08-03

公共模型 grok-video-1.5 支持文生视频、单图生视频和多参考图生视频。通过 UniAll 异步视频接口提交任务，然后轮询任务，直到任务完成或失败。

1. 能力范围

生成方式	图片输入	`prompt`	最高分辨率
文生视频	不传图片字段	必填	`1080p`
单图生视频	一个 `image` 或 `image_url`	可选	`1080p`
参考图生视频	1 到 7 个 `reference_images` 或 `reference_image_urls`	必填	`720p`

本模型还支持：

1 到 15 秒，默认 8 秒；
480p、720p、1080p，默认 480p；
auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3 画面比例；
HTTP(S) 图片 URL 和完整的图片 Data URL。

本公共模型不开放参考音频、源视频编辑或视频续写。编辑和续写请继续使用现有 Grok Imagine 视频模型。

2. 适用场景

以下场景适合使用 grok-video-1.5：

只用提示词生成视频；
让一张图片动起来，可选是否补充提示词；
使用 1 到 7 张参考图保持人物、商品或视觉风格一致；
文生视频或单图生视频需要最高 1080p 输出。

首尾帧、参考音频、视频编辑和视频续写不属于本模型能力。

3. 接口与鉴权

新接入建议使用以下主要接口：

用途	方法	路径
创建视频任务	`POST`	`/v1/videos`
查询视频任务	`GET`	`/v1/videos/{task_id}`

兼容的 /v1/videos/generations 创建和查询路径继续可用。

所有请求均需使用 Bearer Token：

Authorization: Bearer sk-***

创建任务时还需携带：

Content-Type: application/json

4. 请求体参数

参数	类型	必填	说明
`model`	string	是	固定传 `grok-video-1.5`。
`prompt`	string	条件必填	文生视频和参考图生视频必填；单图生视频可选。
`duration`	integer 或整数字符串	否	`1` 到 `15`，默认 `8`。
`seconds`	integer 或整数字符串	否	`duration` 的兼容别名；同时传入时两者必须一致。
`resolution`	string	否	`480p`、`720p`、`1080p`，默认 `480p`；参考图生视频最高 `720p`。
`size`	string	否	`resolution` 的兼容别名；同时传入时两者必须一致。
`aspect_ratio`	string	否	`auto`、`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`。
`image`	object	否	单张结构化图片，固定形式为 `{"url":"..."}`。
`image_url`	string	否	单图兼容字段。
`reference_images`	object[]	否	1 到 7 张结构化参考图，形式为 `[{"url":"..."}]`。
`reference_image_urls`	string[]	否	兼容字段，包含 1 到 7 个图片 URL 或 Data URL。

新接入建议优先使用 duration、resolution 以及结构化的 image 或 reference_images 字段。

图片字段选择

四个图片字段互斥。图片类请求只能选择其中一个：

输入形式	使用字段
单张结构化图片	`image: {"url":"..."}`
单张兼容字符串	`image_url: "..."`
多张结构化参考图	`reference_images: [{"url":"..."}]`
多张兼容字符串参考图	`reference_image_urls: ["..."]`

不要在同一个请求中混用单图字段和参考图字段。

支持的图片值

每个图片值必须是以下形式之一：

服务端可访问的 http:// 或 https:// URL；
完整的图片 Data URL，例如 data:image/png;base64,...。

裸 Base64、本机路径、依赖浏览器登录态的 URL、images、image_urls 以及任何形式的 file_id 都会被拒绝。

5. 请求示例

5.1 文生视频

下面的请求使用 1080p 和默认 8 秒时长：

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "A quiet mountain lake at sunrise, gentle camera movement, realistic reflections.",
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

5.2 使用 HTTP URL 的单图生视频

单图生视频可以不传提示词：

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "image": {
      "url": "https://example.com/product.jpg"
    },
    "duration": 6,
    "resolution": "720p"
  }'

5.3 使用 Data URL 的单图生视频

必须传入包含媒体类型和 Base64 前缀的完整 Data URL：

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "Subtle camera push-in and natural fabric movement.",
    "image_url": "data:image/png;base64,iVBORw0KGgo...",
    "duration": 5,
    "size": "480p",
    "aspect_ratio": "9:16"
  }'

5.4 多参考图生视频

参考图生视频接受 1 到 7 张图片，分辨率只支持 480p 或 720p：

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "Keep the character identity and clothing consistent while the character turns toward the camera.",
    "reference_images": [
      {"url": "https://example.com/character-front.jpg"},
      {"url": "https://example.com/character-side.jpg"}
    ],
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'

6. 响应示例

任务创建成功

请保存 id 或兼容字段 task_id，后续用于查询任务。

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "grok-video-1.5",
  "status": "queued",
  "raw_status": "PENDING",
  "progress": 0,
  "created_at": 1785715200,
  "video_url": null
}

7. 任务状态与结果

创建成功后保存 id 或 task_id，随后调用 GET /v1/videos/{task_id}，直到任务进入 completed 或 failed。统一的轮询间隔、状态字段、错误结构、结果地址和鉴权下载方式见视频生成概览。

8. 画面比例行为

文生视频未传 aspect_ratio 时，实际默认值通常为 16:9。
单图生视频未传时，输出通常跟随输入图片比例。
auto 作为兼容值继续接受。
如需稳定构图，请提前把源图和参考图处理为目标输出方向。

9. 计费说明

本文档不定义精确用户价格。归一后的时长、分辨率和输入图片数量都会影响计费：

未传时长时，按默认 8 秒计算；
文生视频没有输入图片计费维度；
单图生视频计 1 张输入图；
参考图生视频按实际参考图数量计算；
更高分辨率通常价格更高。

请在 UniAll 控制台查看当前价格，并在任务创建后核对账户用量。原任务进入终态前，不要重复提交。

10. 常见错误

缺少 `prompt`

文生视频和参考图生视频必须传 prompt。只有单图生视频可以省略提示词。

图片字段冲突

不要混用 image、image_url、reference_images 或 reference_image_urls，只能选择其中一个。

图片编码不合法

请使用 HTTP(S) URL 或完整 Data URL。iVBORw0KGgo... 这样的裸 Base64 字符串无效。

参考图生视频请求 `1080p`

参考图生视频最高支持 720p。请改用 480p 或 720p；如需 1080p，应使用文生视频或单图生视频。

参考图数量超限

reference_images 和 reference_image_urls 只接受 1 到 7 张图片。空数组或超过 7 张都会被拒绝。

传入未开放字段

不要传 file_id、reference_audios、reference_audio_urls、voice_id、output、storage_options 或 user，也不要把它们放进 extra_body。

请求不支持的视频操作

参考音频、首尾帧、视频编辑和视频续写不属于 grok-video-1.5。

11. 从旧契约迁移

项目	旧契约	当前契约
生成方式	仅单图生视频	文生、单图、1 到 7 张参考图生视频
图片字段	仅 `image_url`	结构化 `image` / `reference_images`，同时保留兼容 URL 字段
图片值	仅 HTTP(S) URL	HTTP(S) URL 或完整图片 Data URL
单图提示词	必填	可选
时长	必填整数 `duration`	`duration` 或 `seconds`，`1..15`，默认 `8`
分辨率	`480p` 或 `720p`	文生和单图新增 `1080p`
画面比例	六种比例和 `auto`	新增 `4:3`、`3:4`

不要迁移到渠道原生模型名或文件 ID。继续使用稳定公共模型 grok-video-1.5 和 UniAll 任务接口。

1. 能力范围​

2. 适用场景​

3. 接口与鉴权​

4. 请求体参数​

图片字段选择​

支持的图片值​

5. 请求示例​

5.1 文生视频​

5.2 使用 HTTP URL 的单图生视频​

5.3 使用 Data URL 的单图生视频​

5.4 多参考图生视频​

6. 响应示例​

任务创建成功​

7. 任务状态与结果​

8. 画面比例行为​

9. 计费说明​

10. 常见错误​

缺少 prompt​

图片字段冲突​

图片编码不合法​

参考图生视频请求 1080p​

参考图数量超限​

传入未开放字段​

请求不支持的视频操作​

11. 从旧契约迁移​

12. 相关页面​