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

# Vidu 视频概览

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

# Vidu 视频

Vidu 视频系列目前提供三套接入方式：官方格式（`/vidu/ent/v2/*`）、OpenAI 兼容的 `/v1/videos`（`multipart/form-data` 格式），以及统一视频的 `/v1/video/create` 与 `/v1/video/query`（JSON）。

## 官方格式

使用 `/vidu/ent/v2/*` 系列接口，支持多种视频生成模式。

<CardGroup cols={2}>
  <Card title="文生视频" icon="clapperboard" href="/zh/videos/vidu/text2video">
    `POST /vidu/ent/v2/text2video`，纯文本生成视频。
  </Card>

  <Card title="图生视频" icon="image" href="/zh/videos/vidu/img2video">
    `POST /vidu/ent/v2/img2video`，首帧图生成视频。
  </Card>

  <Card title="首尾帧生视频" icon="film" href="/zh/videos/vidu/start-end2video">
    `POST /vidu/ent/v2/start-end2video`，首尾帧生成视频。
  </Card>

  <Card title="参考生视频" icon="users" href="/zh/videos/vidu/reference2video">
    `POST /vidu/ent/v2/reference2video`，主体参考生成视频。
  </Card>

  <Card title="查询任务" icon="hourglass" href="/zh/videos/vidu/query">
    `GET /vidu/ent/v2/task/{task_id}/creations`，查询任务状态与结果。
  </Card>
</CardGroup>

### 支持模型（官方格式）

| 模型                          | 说明           | 时长规则   |
| --------------------------- | ------------ | ------ |
| `viduq3-pro`                | 高效生成优质音视频内容  | 按模型而定  |
| `viduq2` / `viduq2-pro`     | 新模型，效果好，细节丰富 | 1-10 秒 |
| `viduq2-turbo`              | 新模型，效果好，生成快  | 1-10 秒 |
| `viduq1` / `viduq1-classic` | 画面清晰，平滑转场    | 按模型而定  |
| `vidu2.0`                   | 生成速度快        | 按模型而定  |

## OpenAI 格式

使用 `POST /v1/videos` 提交、`GET /v1/videos/{task_id}` 查询，以 `multipart/form-data` 提交。

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

  <Card title="任务状态查询" icon="hourglass" href="/zh/videos/vidu/vidu-query">
    `GET /v1/videos/{task_id}`，查询任务状态与结果。
  </Card>
</CardGroup>

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

| 模型             | 说明                           |
| -------------- | ---------------------------- |
| `viduq3-pro`   | 高效生成优质音视频内容，让视频内容更生动、更形象、更立体 |
| `viduq2-pro`   | 新模型，效果好，细节丰富                 |
| `viduq2-turbo` | 新模型，效果好，生成快                  |

## 统一视频

使用 `POST /v1/video/create` 创建任务，查询使用 `GET /v1/video/query?id=`。

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

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

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

| 能力     | 传参方式          | 说明         |
| ------ | ------------- | ---------- |
| 文生视频   | `images: []`  | 仅文本提示      |
| 首帧生视频  | `images` 1 张  | 首帧图 + 文本提示 |
| 首尾帧生视频 | `images` 2 张  | 首帧 + 尾帧    |
| 参考生视频  | `subjects` 数组 | 主体参考图      |

## 对比

| 项目   | 官方格式                                        | OpenAI 格式                  | 统一视频                      |
| ---- | ------------------------------------------- | -------------------------- | ------------------------- |
| 创建   | `/vidu/ent/v2/*`                            | `POST /v1/videos`          | `POST /v1/video/create`   |
| 查询   | `GET /vidu/ent/v2/task/{task_id}/creations` | `GET /v1/videos/{task_id}` | `GET /v1/video/query?id=` |
| 请求格式 | JSON                                        | multipart/form-data        | JSON                      |
| 参考图  | `images` / `subjects`                       | `images`                   | `images`                  |
| 画幅   | `aspect_ratio`                              | `aspect_ratio`             | `aspect_ratio`            |
| 分辨率  | `resolution`                                | `resolution`               | `size`                    |
| 时长   | `duration`                                  | `duration`                 | `duration`                |

## 参数约束

| 字段             | 可用值                             | 说明                   |
| -------------- | ------------------------------- | -------------------- |
| `aspect_ratio` | `16:9`、`9:16`、`3:4`、`4:3`、`1:1` | 3:4、4:3 仅支持 q2、q3 模型 |
| `resolution`   | `540p`、`720p`、`1080p`           | 分辨率规格                |
| `duration`     | `1`-`10`                        | 视频时长（秒），q2 默认 5      |
| `style`        | `general`、`anime`               | 风格（q2、q3 不生效）        |

## 特色功能

| 功能    | 说明                              |
| ----- | ------------------------------- |
| 音视频直出 | `audio: true`，输出带台词和音效的视频（仅 q3） |
| 背景音乐  | `bgm: true`，自动添加 BGM            |
| 错峰模式  | `off_peak: true`，错峰生成，积分更低      |
| 推荐提示词 | `is_rec: true`，系统自动推荐提示词        |
| 水印    | `watermark: true`，添加固定水印        |

## 相关页面

* [视频模型支持矩阵](/zh/videos/model-matrix)
* [文生视频（官方格式）](./text2video)
* [图生视频（官方格式）](./img2video)
* [首尾帧生视频（官方格式）](./start-end2video)
* [参考生视频（官方格式）](./reference2video)
* [查询任务（官方格式）](./query)
* [视频生成（OpenAI 格式）](./vidu-generation)
* [任务状态查询（OpenAI 格式）](./vidu-query)
* [生成视频（统一视频）](./unified-generation)
* [查询任务（统一视频）](./unified-query)