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

# Vidu · 概览

> Vidu 视频生成服务使用指南

## 什么是 Vidu

Vidu 是一个强大的 AI 视频生成服务，支持文生视频、图生视频、参考生视频等多种创作方式。通过本平台，您可以直接调用 Vidu 的能力，无需单独注册 Vidu 账号。

## 核心能力

* **文生视频**：输入文字描述，生成对应视频
* **图生视频**：上传图片，生成动态视频
* **参考生视频**：基于参考视频生成新视频
* **首尾帧生成**：提供首尾两帧图片，生成中间过渡视频
* **对口型（lip-sync）**：为视频添加音频或文字配音

## 使用前准备

您只需要准备：

1. **平台 API Key**：在本平台用户中心获取（形如 `sk-xxxx`）
2. **API 地址**：平台提供的网关地址（如 `https://models.kapon.cloud`）

就这么简单！无需注册 Vidu 账号，平台已为您配置好一切。

## 计费说明

* 平台按实际使用量计费，费用直接从您的账户余额扣除
* 不同模型、分辨率、时长对应不同价格，具体可在"模型价格"页面查看
* 错峰模式（`off_peak=true`）可享受半价优惠
* 生成失败或审核不通过不会扣费

## 可用模型

### 图生视频 / 首尾帧模型

* `viduq2-pro-fast`、`viduq2-pro`、`viduq2-turbo`
* `viduq1`、`viduq1-classic`
* `vidu2.0`、`vidu1.5`

### 文生视频 / 参考生视频模型

* `viduq2`、`viduq1`
* `vidu2.0`、`vidu1.5`

## API 基础

所有 Vidu 相关接口统一使用 `/vidu` 路径前缀，认证方式为在请求头中添加：

```
Authorization: Bearer <kapon Token>
```

## 快速上手

### 1. 文生视频

```bash theme={null}
curl -X POST "https://models.kapon.cloud/vidu/ent/v2/text2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2-pro",
    "prompt": "海边日落，电影风格",
    "duration": 4,
    "resolution": "720p",
    "style": "general"
  }'
```

### 2. 图生视频

```bash theme={null}
curl -X POST "https://models.kapon.cloud/vidu/ent/v2/img2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu1.5",
    "images": ["https://your.cdn.com/image.png"],
    "duration": 4,
    "resolution": "720p",
    "off_peak": true
  }'
```

### 3. 查询任务状态

```bash theme={null}
curl "https://models.kapon.cloud/vidu/ent/v2/tasks/{task_id}/creations" \
  -H "Authorization: Bearer <kapon Token>"
```

## 实用技巧

* **节省费用**：使用 `off_peak=true` 开启错峰模式，享受半价优惠
* **添加水印**：通过 `watermark`、`wm_position`、`wm_url` 参数自定义水印
* **选择风格**：`style` 参数支持 `general`（通用）和 `anime`（动漫）风格
* **控制质量**：根据需求选择合适的分辨率（720p、1080p）和时长

## 页面导航

<CardGroup>
  <Card title="视频生成" href="/vidu/video-generation" icon="film" />

  <Card title="任务查询" href="/vidu/video-query" icon="magnifying-glass" />

  <Card title="对口型（lip-sync）" href="/vidu/lip-sync" icon="microphone" />
</CardGroup>

## 推荐阅读顺序

1. **先看本页**：了解整体能力和计费规则
2. **按需查看**：
   * [视频生成](/vidu/video-generation)：文生/图生/参考生/首尾帧的详细参数与示例
   * [任务查询](/vidu/video-query)：如何轮询任务结果、如何取消任务
   * [对口型](/vidu/lip-sync)：基于已有视频添加音频或文字配音