> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magic666.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 | 按字符串传入秒数      | 单图传 `image`              |

## 常见能力

| 能力                | 传参方式                    | 说明                                                                                        |
| ----------------- | ----------------------- | ----------------------------------------------------------------------------------------- |
| 文生视频              | 仅传文本字段                  | 不需要上传参考图                                                                                  |
| Grok Imagine 图生视频 | JSON `image` 或 `images` | `grok-imagine-video-1.5-preview` 使用单图 `image`；`grok-imagine-video` 可使用 `image` 或 `images` |

## 参数约束

| 字段             | 可用值                                | 说明                                                |
| -------------- | ---------------------------------- | ------------------------------------------------- |
| `aspect_ratio` | Grok Imagine 支持常见比例和 `数字:数字` 自定义比例 | 建议显式传入目标比例                                        |
| `resolution`   | `480P`、`720P`、`1080P`              | Grok Imagine 1.5 支持 `1080P`                       |
| `seconds`      | 字符串形式的秒数                           | 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)