Grok Video 1.5 视频生成

更新时间：2026-06-26

本文介绍如何在 aijisu 中调用 grok-video-1.5。该模型用于单图生视频：用户提供一张输入图片和一段提示词，平台异步生成视频任务。

1. 可用模型

模型	能力	输入图片	输出清晰度
`grok-video-1.5`	单图生视频	仅支持 1 张	`480p`、`720p`、`1080p`

说明：

grok-video-1.5 是独立模型名，不要和旧版 grok-imagine 混用。
当前只支持单图生视频，不支持文生视频、多参考图、视频输入、视频编辑或视频续写。
输入图片必须是平台和上游服务可访问的图片 URL。
当前没有独立的横屏/竖屏参数；需要横屏请传横向输入图，需要竖屏请传竖向输入图。

2. 接口

2.1 创建视频任务

POST /v1/videos

请求头：

Authorization: Bearer sk-***
Content-Type: application/json

2.2 查询视频任务

GET /v1/videos/{task_id}

兼容查询接口：

GET /v1/videos/generations/{task_id}

2.3 获取视频文件

GET /v1/videos/{task_id}/content

任务完成后，可以直接读取查询响应中的 video_url，也可以通过 /content 接口获取视频文件流。

3. 参数说明

参数	类型	必填	说明
`model`	string	是	固定传 `grok-video-1.5`
`prompt`	string	是	视频生成提示词，建议描述主体、动作、镜头、风格和禁止项
`image`	string	二选一	输入图片 URL；和 `image_url` 二选一
`image_url`	string	二选一	输入图片 URL；和 `image` 二选一
`duration`	integer	否	输出视频秒数，支持 `1-15`，建议显式传入
`seconds`	string	否	输出视频秒数的兼容字段；优先推荐使用 `duration`
`size`	string	否	输出清晰度，支持 `480p`、`720p`、`1080p`
`resolution`	string	否	输出清晰度的兼容字段；优先推荐使用 `size`

字段约束：

image 和 image_url 只传一个即可。
不要同时传 images、image_urls、reference_image_urls 等多图字段。
不要传 video、video_url、videos、video_urls 等视频输入字段。
不要传 aspect_ratio。
不要传 extra_body.operation 来请求编辑、续写、参考视频或文生视频能力。
size / resolution 只表示清晰度档，不表示横屏或竖屏；画面方向请通过输入图片比例控制。
如果同时传 size 和 resolution，建议保持二者值一致。

4. 请求示例

以下示例中的 {BASE_URL} 可替换为 https://api.aijisu.cn。

4.1 使用 `image_url`

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "A cinematic close-up of a glass perfume bottle on a marble table, soft morning light, slow camera push-in, elegant product video, no text, no logo.",
    "image_url": "https://example.com/source.jpg",
    "duration": 6,
    "size": "720p"
  }'

4.2 使用 `image`

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 landscape photo becomes a gentle animated scene, leaves moving in the wind, soft natural lighting, stable camera, no text.",
    "image": "https://example.com/landscape.png",
    "duration": 8,
    "size": "1080p"
  }'

4.3 480p 快速预览

curl -X POST "{BASE_URL}/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5",
    "prompt": "A simple product shot, the object slowly rotates on a clean white background, smooth motion, no text.",
    "image_url": "https://example.com/product.jpg",
    "duration": 4,
    "size": "480p"
  }'

5. 创建响应示例

创建成功后会返回任务对象。此时视频通常还在队列或生成中。

{
  "id": "task_xxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "grok-video-1.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1782400000
}

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

6. 查询任务

curl "{BASE_URL}/v1/videos/task_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-***"

处理中响应示例：

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "grok-video-1.5",
  "status": "in_progress",
  "progress": 35,
  "created_at": 1782400000
}

完成响应示例：

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "grok-video-1.5",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/generated-video.mp4",
  "result": {
    "video_url": "https://example.com/generated-video.mp4",
    "outputs": [
      "https://example.com/generated-video.mp4"
    ]
  }
}

7. 下载视频

方式一：直接使用查询响应里的 video_url。

方式二：通过任务内容接口获取文件流。

curl -L "{BASE_URL}/v1/videos/task_xxxxxxxxxxxxx/content" \
  -H "Authorization: Bearer sk-***" \
  -o grok-video-1.5-output.mp4

8. 状态说明

状态	说明
`queued`	任务已创建，等待处理
`in_progress`	任务处理中
`completed`	任务完成，可以读取视频 URL
`failed`	任务失败，查看响应中的 `error.message`

客户端建议每隔 3 到 10 秒轮询一次，直到任务进入 completed 或 failed。

9. 常见错误

把模型发到图片接口

grok-video-1.5 是视频模型，应调用 /v1/videos，不要发到 /v1/images/generations。

没有传输入图片

该模型必须传 image 或 image_url。只传 prompt 会被拒绝。

传了多张图片

该模型只支持一张输入图片。不要传 images、image_urls 或 reference_image_urls。

传了视频输入

该模型不支持视频输入。不要传 video、video_url、videos 或 video_urls。

清晰度格式错误

size 或 resolution 只能传：

480p
720p
1080p

不要传 1920x1080、1280x720、4k 或其他像素尺寸字符串。

想用 `aspect_ratio` 控制横竖屏

该模型当前不支持 aspect_ratio。请在提交前把输入图片裁剪为目标画面方向，例如横屏使用横向图片，竖屏使用竖向图片。

请求编辑或续写能力

grok-video-1.5 不支持编辑和续写。不要传：

{
  "extra_body": {
    "operation": "edit_video"
  }
}

或：

{
  "extra_body": {
    "operation": "video_extend"
  }
}

10. 提示词建议

提示词建议包含：

主体：画面中要动起来的对象。
动作：主体如何运动。
镜头：推进、拉远、平移、固定机位等。
风格：真实摄影、电影感、产品广告、自然光等。
限制：不要文字、不要 logo、不要人物等。

示例：

A cinematic product video of the object slowly rotating on a clean studio background, soft natural light, smooth camera push-in, realistic texture, no text, no logo.

11. 最小可用请求

{
  "model": "grok-video-1.5",
  "prompt": "A calm product video, slow camera movement, soft light, no text.",
  "image_url": "https://example.com/source.jpg",
  "duration": 6,
  "size": "720p"
}

1. 可用模型​

2. 接口​

2.1 创建视频任务​

2.2 查询视频任务​

2.3 获取视频文件​

3. 参数说明​

4. 请求示例​

4.1 使用 image_url​

4.2 使用 image​

4.3 480p 快速预览​

5. 创建响应示例​

6. 查询任务​

7. 下载视频​

8. 状态说明​

9. 常见错误​

把模型发到图片接口​

没有传输入图片​

传了多张图片​

传了视频输入​

清晰度格式错误​

想用 aspect_ratio 控制横竖屏​

请求编辑或续写能力​

10. 提示词建议​

11. 最小可用请求​