> ## 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 Video Overview

> A model-series-organized overview of Grok's OpenAI format and unified video interfaces.

# Grok Video

The Grok video series currently provides two integration methods: OpenAI-compatible `/v1/videos` (primarily `multipart/form-data`), and the unified video `/v1/video/*` and `/v1/video/query` (JSON).

## OpenAI Format

Use `POST /v1/videos` to submit and `GET /v1/videos/{task_id}` to query, with support for derivative capabilities such as remix, extend, and extensions.

<CardGroup cols={2}>
  <Card title="Grok Video Generation" icon="clapperboard" href="/en/videos/grok/generation">
    `POST /v1/videos`, submit Grok video tasks via multipart.
  </Card>

  <Card title="Video Remix" icon="wand-sparkles" href="/en/videos/grok/remix">
    `POST /v1/videos/{video_id}/remix`, perform a remix based on the original task.
  </Card>

  <Card title="Video Extend" icon="film" href="/en/videos/grok/extend">
    `POST /v1/videos/{video_id}/extend`, extend the video from a specified timestamp.
  </Card>

  <Card title="Video Extensions" icon="layers" href="/en/videos/grok/extensions">
    `POST /v1/videos/extensions`, reference the original task via `video.url` for extension.
  </Card>

  <Card title="Grok Task Query" icon="hourglass" href="/en/videos/grok/query">
    `GET /v1/videos/{task_id}`, query an OpenAI-style `video` object.
  </Card>
</CardGroup>

### Supported Models (OpenAI Format)

| Model              | Description                                                                                                       | Duration Rule            |
| ------------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------ |
| `grok-video-3`     | Standard version, supports text-to-video, first frame, first and last frame, and reference-based video generation | As passed in the request |
| `grok-video-3-pro` | Pro version                                                                                                       | Fixed `10s`              |
| `grok-video-3-max` | Max version                                                                                                       | Fixed `15s`              |

## Unified Video

Use `POST /v1/video/create` to create tasks, and support derivative capabilities such as `POST /v1/video/remix`, `POST /v1/video/extend`, and `POST /v1/videos/extensions`; query via `GET /v1/video/query?id=`.

<CardGroup cols={2}>
  <Card title="Create Video" icon="clapperboard" href="/en/videos/grok/unified-generation">
    `POST /v1/video/create`, submit Grok tasks in the unified video format.
  </Card>

  <Card title="Video Remix" icon="wand-sparkles" href="/en/videos/grok/unified-remix">
    `POST /v1/video/remix`, pass `task_id` in the body.
  </Card>

  <Card title="Video Extend" icon="film" href="/en/videos/grok/unified-extend">
    `POST /v1/video/extend`, pass `task_id` and `start_time` in the body.
  </Card>

  <Card title="Video Extensions" icon="layers" href="/en/videos/grok/unified-extensions">
    `POST /v1/videos/extensions`, set `video.url` in the body to the original task ID.
  </Card>

  <Card title="Query Task" icon="hourglass" href="/en/videos/grok/unified-query">
    `GET /v1/video/query`, query status and results by task `id`.
  </Card>
</CardGroup>

### Common Capabilities (Unified Video)

| Capability            | Parameter Method                | Description                                    |
| --------------------- | ------------------------------- | ---------------------------------------------- |
| Text-to-video         | `images: []`                    | Text prompt only                               |
| First and last frame  | `images` with 2 images in order | First frame + last frame                       |
| Multi-image reference | Multiple `images` + `@imgN`     | Reference the corresponding images in `prompt` |

## Comparison

| Item            | OpenAI Format                       | Unified Video                              |
| --------------- | ----------------------------------- | ------------------------------------------ |
| Create          | `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`) |
| Query           | `GET /v1/videos/{task_id}`          | `GET /v1/video/query?id=`                  |
| Request format  | `multipart/form-data`               | JSON                                       |
| Reference image | `input_reference`                   | `images`                                   |
| Aspect ratio    | `aspect_ratio`                      | `aspect_ratio`                             |
| Resolution      | `size` (`720P` / `1080P`)           | `size` (`720P` / `1080P`)                  |
| Duration        | `seconds`                           | `duration` (default 10, supports 6/10/15)  |

## Parameter Constraints (Common to Both)

| Field          | Available Values                    | Description                                                                                                        |
| -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `aspect_ratio` | `16:9`, `9:16`, `2:3`, `3:2`, `1:1` | The unified video docs cover the full set of ratios; the OpenAI format currently commonly uses `2:3`, `3:2`, `1:1` |
| `size`         | `720P`, `1080P`                     | Resolution specifications                                                                                          |

## Related Pages

* [Video Model Support Matrix](/en/videos/model-matrix)
* [Grok Video Generation (OpenAI Format)](./generation)
* [Video Remix](./remix)
* [Video Extend](./extend)
* [Video Extensions](./extensions)
* [Grok Task Query (OpenAI Format)](./query)
* [Create Video (Unified Video)](./unified-generation)
* [Video Remix (Unified Video)](./unified-remix)
* [Video Extend (Unified Video)](./unified-extend)
* [Video Extensions (Unified Video)](./unified-extensions)
* [Query Task (Unified Video)](./unified-query)