> ## 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.

# Jimeng Video Overview

> Organizes Jimeng Video's three integration methods by model series: OpenAI format, unified video, and Doubao channel.

# Jimeng Video

The Jimeng Video series currently provides three integration methods: OpenAI-compatible `/v1/videos` (JSON/multipart), unified video `/v1/video/create` and `/v1/video/query` (JSON), and the Doubao channel `/v1/videos` (multipart/form-data).

## OpenAI Format

Use `POST /v1/videos` to submit and `GET /v1/videos/{task_id}` to query.

<CardGroup cols={2}>
  <Card title="Video Generation" icon="clapperboard" href="/en/videos/jimeng/generation">
    `POST /v1/videos`, submit a Jimeng Video task.
  </Card>

  <Card title="Task Status Query" icon="hourglass" href="/en/videos/jimeng/query">
    `GET /v1/videos/{task_id}`, query task status and results.
  </Card>
</CardGroup>

### Supported Models (OpenAI Format)

| Model              | Description        | Duration Rule                |
| ------------------ | ------------------ | ---------------------------- |
| `jimeng-video-3.0` | Jimeng version 3.0 | Based on the request payload |
| `jimeng-video-2.0` | Jimeng version 2.0 | Based on the request payload |

## Unified Video

Use `POST /v1/video/create` to create a task, and `GET /v1/video/query?id=` for querying.

<CardGroup cols={2}>
  <Card title="Generate Video" icon="clapperboard" href="/en/videos/jimeng/unified-generation">
    `POST /v1/video/create`, submit a Jimeng task in the unified video format.
  </Card>

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

### Common Capabilities (Unified Video)

| Capability                    | Parameter Format  | Description                     |
| ----------------------------- | ----------------- | ------------------------------- |
| Text-to-video                 | `images: []`      | Text prompt only                |
| First-frame-to-video          | `images` 1 image  | First-frame image + text prompt |
| First-and-last-frame-to-video | `images` 2 images | First frame + last frame        |

## Doubao Channel

Use `POST /v1/videos` to submit and `GET /v1/videos/{task_id}` to query, submitted as `multipart/form-data`.

<CardGroup cols={2}>
  <Card title="Video Generation" icon="clapperboard" href="/en/videos/jimeng/doubao-generation">
    `POST /v1/videos`, submit a Doubao video task.
  </Card>

  <Card title="Task Status Query" icon="hourglass" href="/en/videos/jimeng/doubao-query">
    `GET /v1/videos/{task_id}`, query task status and results.
  </Card>
</CardGroup>

### Supported Models (Doubao Channel)

| Model                           | Description              |
| ------------------------------- | ------------------------ |
| `doubao-seedance-1-0-pro_480p`  | Doubao version 1.0 480p  |
| `doubao-seedance-1-0-pro_720p`  | Doubao version 1.0 720p  |
| `doubao-seedance-1-0-pro_1080p` | Doubao version 1.0 1080p |
| `doubao-seedance-1-5-pro_480p`  | Doubao version 1.5 480p  |
| `doubao-seedance-1-5-pro_720p`  | Doubao version 1.5 720p  |
| `doubao-seedance-1-5-pro_1080p` | Doubao version 1.5 1080p |

## Comparison

| Item            | OpenAI Format              | Unified Video             | Doubao Channel                           |
| --------------- | -------------------------- | ------------------------- | ---------------------------------------- |
| Create          | `POST /v1/videos`          | `POST /v1/video/create`   | `POST /v1/videos`                        |
| Query           | `GET /v1/videos/{task_id}` | `GET /v1/video/query?id=` | `GET /v1/videos/{task_id}`               |
| Request Format  | JSON / multipart           | JSON                      | multipart/form-data                      |
| Reference Image | `input_reference`          | `images`                  | `first_frame_image` / `last_frame_image` |
| Aspect Ratio    | `aspect_ratio`             | `aspect_ratio`            | `size`                                   |
| Resolution      | `size`                     | `size`                    | Included in the model name               |
| Duration        | `seconds`                  | `duration`                | `seconds` (4-11 seconds)                 |

## Parameter Constraints

### OpenAI Format

| Field          | Available Values       | Description                             |
| -------------- | ---------------------- | --------------------------------------- |
| `aspect_ratio` | `16:9`, `9:16`, `1:1`  | Video aspect ratio                      |
| `size`         | `720x1280`, `1280x720` | Resolution specification (pixel values) |
| `seconds`      | `5`, `10`, `15`        | Video duration (seconds)                |

### Unified Video

| Field          | Available Values                            | Description              |
| -------------- | ------------------------------------------- | ------------------------ |
| `aspect_ratio` | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9` | Video aspect ratio       |
| `size`         | `720P`, `1080P`                             | Resolution specification |
| `duration`     | `5`, `10`, `15`                             | Video duration (seconds) |

### Doubao Channel

| Field        | Available Values           | Description                               |
| ------------ | -------------------------- | ----------------------------------------- |
| `size`       | `keep_ratio`, `adaptive`   | Size control options                      |
| `seconds`    | `4`-`11`                   | Video duration (seconds)                  |
| Model suffix | `_480p`, `_720p`, `_1080p` | Resolution is specified in the model name |

## Related Pages

* [Video Model Support Matrix](/en/videos/model-matrix)
* [Jimeng Video Generation (OpenAI Format)](./generation)
* [Task Status Query (OpenAI Format)](./query)
* [Generate Video (Unified Video)](./unified-generation)
* [Query Task (Unified Video)](./unified-query)
* [Doubao Video Generation](./doubao-generation)
* [Doubao Task Status Query](./doubao-query)