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

# Vidu 视频 API

> Vidu Q1 / Q2 / Q3 快速上手——文本、图像、参考图以及首尾帧视频生成，并支持原生音频。

## 概述

**Vidu** 是在 VibeToken 上提供的视频生成系列。
共开放三个代际，每个代际都包含若干任务：

* **Q1** — 统一定价，固定 5s / 1080p 片段。
* **Q2** — 可变 1–10s，支持 540p / 720p / 1080p，按秒计费，
  可选音频。
* **Q3** — 可变 1–16s，支持**原生音视频协同生成**
  （含音频），按秒统一定价。

|              |                                                                    |
| ------------ | ------------------------------------------------------------------ |
| **Provider** | Vidu                                                               |
| **系列**       | `vidu-q1`, `vidu-q2`, `vidu-q3`                                    |
| **模态**       | 视频                                                                 |
| **支持的任务**    | `text-to-video`, `image-to-video`, `reference-to-video`, start-end |
| **分辨率**      | 1080p (Q1); 540p / 720p / 1080p (Q2, Q3)                           |

## 端点

```http theme={null}
POST https://vibetoken.cn/v1/videos/generations
```

这是一个**异步**端点。POST 会立即返回
`{id, status: "pending"}`；请轮询 `GET /v1/videos/generations/{id}`
直到 `status` 变为 `success`（带 `data: [{url}]`）或 `failed`。

## 模型

* [**Vidu Q1**](/vidu-video-api/q1) — `vidu/q1-t2v`, `vidu/q1-i2v`,
  `vidu/q1-r2v`
* [**Vidu Q2**](/vidu-video-api/q2) — `vidu/q2-t2v`, `vidu/q2-pro-i2v`,
  `vidu/q2-turbo-i2v`, `vidu/q2-r2v`, `vidu/q2-pro-fast`
* [**Vidu Q3**](/vidu-video-api/q3) — `vidu/q3-turbo-t2v`,
  `vidu/q3-pro-t2v`, `vidu/q3-turbo-i2v`, `vidu/q3-pro-i2v`,
  `vidu/q3-turbo-f2v`, `vidu/q3-pro-f2v`

## 定价

Vidu 以上游刊例价减去 VibeToken 标准的 15% 提供。Q1 为按视频统一
定价；Q2 和 Q3 按 `duration` 计费。完整价格表请见各代际的
页面。

| 代际 | 计价基准       | 示例                             |
| -- | ---------- | ------------------------------ |
| Q1 | 按视频统一价     | $0.40 → **$0.34\*\*            |
| Q2 | 首秒 + 每秒    | 5s @ 720p Pro i2v ≈ **\$0.23** |
| Q3 | 按秒统一价（含音频） | 5s @ 720p Turbo ≈ **\$0.23**   |

<Note>
  Vidu 平台会根据服务器时间/负载套用五折的"错峰"费率。
  该费率不在 VibeToken 上开放——每个请求都按
  正常（高峰）费率计费，与其他经销商对 Vidu 的定价方式一致。
</Note>

## 认证

所有请求都需要 Bearer 令牌——请在
[vibetoken.cn/api-key](https://vibetoken.cn/api-key) 创建。

```bash theme={null}
curl https://vibetoken.cn/v1/videos/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "vidu/q3-turbo-i2v", "image_urls": ["https://…jpg"], "duration": 5}'
```