> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geeknow.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok 视频概览

> 按模型系列整理 `grok-imagine-video` 与 `grok-imagine-video-1.5-preview` 的视频生成与任务查询接口。

# Grok 视频

Grok 视频系列统一使用 `POST /v1/videos` 创建异步任务，并使用 `GET /v1/videos/{task_id}` 查询状态。

* `grok-imagine-video` / `grok-imagine-video-1.5-preview` 使用 `application/json`；`grok-imagine-video` 通过 `image` 或 `images` 传入参考图，`grok-imagine-video-1.5-preview` 当前仅建议使用单张 `image`。
* Grok Imagine 使用 `model`、`prompt`、`seconds`、`aspect_ratio`、`resolution` 等字段。

<CardGroup cols={2}>
  <Card title="Grok Imagine Video" icon="sparkles" href="/api-reference/videos/grok/grok-imagine-video">
    `grok-imagine-video` 的 JSON 视频生成任务。
  </Card>

  <Card title="Grok Imagine 1.5 Preview" icon="sparkles" href="/api-reference/videos/grok/grok-imagine-video-1-5-preview">
    `grok-imagine-video-1.5-preview` 的视频生成任务。
  </Card>

  <Card title="任务查询" icon="hourglass" href="/api-reference/videos/grok/query">
    `GET /v1/videos/{task_id}`，查询任务状态并获取结果地址。
  </Card>
</CardGroup>

## 支持模型

| 模型                               | 请求格式 | 时长规则          | 参考图规则                    |
| -------------------------------- | ---- | ------------- | ------------------------ |
| `grok-imagine-video`             | JSON | 自定义秒数，最小 `1s` | 单图传 `image`，多图传 `images` |
| `grok-imagine-video-1.5-preview` | JSON | 自定义秒数，最小 `1s` | 当前仅建议传 1 张参考图            |

## 常见能力

| 能力                | 传参方式                    | 说明                                                                      |
| ----------------- | ----------------------- | ----------------------------------------------------------------------- |
| 文生视频              | 仅传文本字段                  | 不需要上传参考图                                                                |
| Grok Imagine 图生视频 | JSON `image` 或 `images` | 单图用 `image`；多图用 `images`，其中 `grok-imagine-video-1.5-preview` 当前仅建议传 1 张 |

## 参数约束

| 字段             | 可用值                                | 说明                                                           |
| -------------- | ---------------------------------- | ------------------------------------------------------------ |
| `aspect_ratio` | Grok Imagine 支持常见比例和 `数字:数字` 自定义比例 | 建议显式传入目标比例                                                   |
| `resolution`   | `480P`、`720P`                      | 仅适用于 `grok-imagine-video` / `grok-imagine-video-1.5-preview` |
| `seconds`      | 大于等于 `1` 的整数秒                      | Grok Imagine 支持自定义秒数                                         |
| `prompt`       | 字符串                                | Grok Imagine 系列建议控制在 `4096` 字符以内；长提示词可能导致上游创建任务失败            |

## 相关页面

* [视频模型支持矩阵](/api-reference/videos/model-matrix)
* [Grok Imagine Video](./grok-imagine-video)
* [Grok Imagine 1.5 Preview](./grok-imagine-video-1-5-preview)
* [Grok 任务查询](./query)