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

# Grok 视频概览

> 按模型系列整理 Grok 的 OpenAI 格式与统一视频接口。

# Grok 视频

Grok 视频系列目前提供两套接入方式：OpenAI 兼容的 `/v1/videos`（以 `multipart/form-data` 为主），以及统一视频的 `/v1/video/*` 与 `/v1/video/query`（JSON）。

## OpenAI 格式

使用 `POST /v1/videos` 提交、`GET /v1/videos/{task_id}` 查询，并支持 remix、extend、extensions 等衍生能力。

<CardGroup cols={2}>
  <Card title="Grok 视频生成" icon="clapperboard" href="/zh/videos/grok/generation">
    `POST /v1/videos`，multipart 提交 Grok 视频任务。
  </Card>

  <Card title="视频Remix" icon="wand-sparkles" href="/zh/videos/grok/remix">
    `POST /v1/videos/{video_id}/remix`，基于原任务做 remix。
  </Card>

  <Card title="视频Extend" icon="film" href="/zh/videos/grok/extend">
    `POST /v1/videos/{video_id}/extend`，从指定时间点延展视频。
  </Card>

  <Card title="视频Extensions" icon="layers" href="/zh/videos/grok/extensions">
    `POST /v1/videos/extensions`，通过 `video.url` 引用原任务做扩展。
  </Card>

  <Card title="Grok 任务查询" icon="hourglass" href="/zh/videos/grok/query">
    `GET /v1/videos/{task_id}`，OpenAI 风格 `video` 对象查询。
  </Card>
</CardGroup>

### 支持模型（OpenAI 格式）

| 模型                 | 说明                    | 时长规则     |
| ------------------ | --------------------- | -------- |
| `grok-video-3`     | 基础版，支持文生、首帧、首尾帧、参考生视频 | 按请求传入    |
| `grok-video-3-pro` | Pro 版                 | 固定 `10s` |
| `grok-video-3-max` | Max 版                 | 固定 `15s` |

## 统一视频

使用 `POST /v1/video/create` 创建任务，并支持 `POST /v1/video/remix`、`POST /v1/video/extend`、`POST /v1/videos/extensions` 等衍生能力；查询使用 `GET /v1/video/query?id=`。

<CardGroup cols={2}>
  <Card title="创建视频" icon="clapperboard" href="/zh/videos/grok/unified-generation">
    `POST /v1/video/create`，统一视频格式提交 Grok 任务。
  </Card>

  <Card title="视频Remix" icon="wand-sparkles" href="/zh/videos/grok/unified-remix">
    `POST /v1/video/remix`，Body 传 `task_id`。
  </Card>

  <Card title="视频Extend" icon="film" href="/zh/videos/grok/unified-extend">
    `POST /v1/video/extend`，Body 传 `task_id` 与 `start_time`。
  </Card>

  <Card title="视频Extensions" icon="layers" href="/zh/videos/grok/unified-extensions">
    `POST /v1/videos/extensions`，Body `video.url` 为原任务 ID。
  </Card>

  <Card title="查询任务" icon="hourglass" href="/zh/videos/grok/unified-query">
    `GET /v1/video/query`，按任务 `id` 查询状态与结果。
  </Card>
</CardGroup>

### 常见能力（统一视频）

| 能力   | 传参方式                  | 说明                 |
| ---- | --------------------- | ------------------ |
| 文生视频 | `images: []`          | 仅文本提示              |
| 首尾帧  | `images` 按顺序 2 张      | 首帧 + 尾帧            |
| 多图参考 | `images` 多张 + `@imgN` | 在 `prompt` 中引用对应图片 |

## 对比

| 项目         | OpenAI 格式                           | 统一视频                                      |
| ---------- | ----------------------------------- | ----------------------------------------- |
| 创建         | `POST /v1/videos`                   | `POST /v1/video/create`                   |
| Remix      | `POST /v1/videos/{video_id}/remix`  | `POST /v1/video/remix`（`task_id`）         |
| Extend     | `POST /v1/videos/{video_id}/extend` | `POST /v1/video/extend`（`task_id`）        |
| Extensions | `POST /v1/videos/extensions`        | `POST /v1/videos/extensions`（`video.url`） |
| 查询         | `GET /v1/videos/{task_id}`          | `GET /v1/video/query?id=`                 |
| 请求格式       | `multipart/form-data`               | JSON                                      |
| 参考图        | `input_reference`                   | `images`                                  |
| 画幅         | `aspect_ratio`                      | `aspect_ratio`                            |
| 分辨率        | `size`（`720P` / `1080P`）            | `size`（`720P` / `1080P`）                  |
| 时长         | `seconds`                           | `duration`（默认 10，支持 6/10/15）              |

## 参数约束（两套通用）

| 字段             | 可用值                             | 说明                                          |
| -------------- | ------------------------------- | ------------------------------------------- |
| `aspect_ratio` | `16:9`、`9:16`、`2:3`、`3:2`、`1:1` | 统一视频文档化全量比例；OpenAI 格式当前常用 `2:3`、`3:2`、`1:1` |
| `size`         | `720P`、`1080P`                  | 分辨率规格                                       |

## 相关页面

* [视频模型支持矩阵](/zh/videos/model-matrix)
* [Grok 视频生成（OpenAI 格式）](./generation)
* [视频Remix](./remix)
* [视频Extend](./extend)
* [视频Extensions](./extensions)
* [Grok 任务查询（OpenAI 格式）](./query)
* [创建视频（统一视频）](./unified-generation)
* [视频Remix（统一视频）](./unified-remix)
* [视频Extend（统一视频）](./unified-extend)
* [视频Extensions（统一视频）](./unified-extensions)
* [查询任务（统一视频）](./unified-query)