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

> Vidu Q3 —— 1–16 秒视频，原生音视频协同生成，按秒统一定价。

|           |                                                                                                                        |
| --------- | ---------------------------------------------------------------------------------------------------------------------- |
| **模型 ID** | `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-q3-turbo`, `vidu-q3-pro`, `vidu-q3-turbo-startend`, `vidu-q3-pro-startend`                                       |
| **任务**    | `text-to-video`, `image-to-video`, 首尾帧 (`f2v`)                                                                         |
| **分辨率**   | 540p, 720p, 1080p                                                                                                      |
| **时长**    | 1–16 秒（默认 5）                                                                                                           |
| **上游**    | Vidu Q3                                                                                                                |

Q3 是 Vidu 的**原生音视频**系列：音频与视频一同生成，且**已包含**在价格中。

## Endpoint

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

异步 —— 返回 `{id, status: "pending"}`；轮询
`GET /v1/videos/generations/{id}` 直到状态为 `success` 或 `failed`。

## Pricing

按档位和分辨率**按秒**统一计费（含音频）。数值为 VibeToken 收费价（Vidu 刊例价 − 15%）；`t2v`、`i2v` 与首尾帧共用同一档位的费率。

| 档位    | 540p        | 720p        | 1080p       |
| ----- | ----------- | ----------- | ----------- |
| Turbo | \$0.030 / s | \$0.047 / s | \$0.055 / s |
| Pro   | \$0.038 / s | \$0.085 / s | \$0.102 / s |

费用 = 费率 × `duration`。一段 5 秒 720p Turbo 视频约 **$0.23**；一段 10 秒 1080p Pro 视频约 **$1.02**。

## Parameters

<ParamField body="prompt" type="string">
  文本提示词。`t2v` **必填**；`i2v` / 首尾帧可选。
  最多 5000（turbo）/ 1500–2000（pro）个字符。
</ParamField>

<ParamField body="image_urls" type="string[]">
  `i2v` —— 恰好 1 张源图。首尾帧 (`f2v`) —— 恰好 2 张，按
  `[start_frame, end_frame]` 顺序排列。需为公开 HTTPS 地址。
</ParamField>

<ParamField body="duration" type="integer" default="5">
  视频时长（秒）。范围 `[1, 16]`。决定计费。
</ParamField>

<ParamField body="resolution" type="enum" default="&#x22;720p&#x22;">
  取 `540p`、`720p`、`1080p` 之一。
</ParamField>

<ParamField body="audio" type="boolean" default="true">
  与视频协同生成音频（已含在价格中）。**例外：**
  在 `q3-pro-i2v` 上，`audio` 改为一个用于对口型输入的音轨 URL
  （mp3/wav/m4a/flac）。
</ParamField>

<ParamField body="audio_type" type="enum" default="&#x22;all&#x22;">
  仅 `turbo-i2v`。取 `all`、`speech_only`、`sound_effect_only` 之一。
</ParamField>

<ParamField body="is_rec" type="boolean" default="false">
  `i2v` / 首尾帧 —— 使音频节奏与视频同步（并在未提供提示词时自动生成一个）。
</ParamField>

<ParamField body="aspect_ratio" type="enum" default="&#x22;16:9&#x22;">
  `t2v` / `pro-i2v`。取 `16:9`、`9:16`、`4:3`、`3:4`、`1:1` 之一。
</ParamField>

<ParamField body="style" type="enum" default="&#x22;general&#x22;">
  仅 `pro-i2v`。取 `general`、`anime` 之一。
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  在输出上叠加上游水印。
</ParamField>

<ParamField body="seed" type="integer">
  随机数生成器初始值。范围 `[0, 2147483647]`。
</ParamField>

## Example

```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://example.com/portrait.jpg"],
    "prompt": "she smiles and waves",
    "duration": 5,
    "resolution": "720p"
  }'
```

## Reference