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

# Vidu · 概览

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

## 什么是 Vidu

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

## 核心能力

| 能力     | 说明                |
| ------ | ----------------- |
| 文生视频   | 输入文字描述，生成对应视频     |
| 图生视频   | 上传图片，生成动态视频       |
| 首尾帧生成  | 提供首尾两帧图片，生成中间过渡视频 |
| 参考生视频  | 基于参考图片生成新视频       |
| 视频替换   | 替换视频中的主体          |
| 对口型    | 为视频添加音频或文字配音      |
| 电商一键成片 | 商品图快速生成广告视频       |
| 可控文生音效 | 基于时间轴生成多段音效事件     |

## 使用前准备

您只需要准备：

1. **平台 API Key**：在用户中心获取（形如 `sk-xxxx`）
2. **API 地址**：`https://models.hingnet.com.cn`

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

## 计费说明

* 按实际使用量计费，费用从账户余额扣除
* 不同模型、分辨率、时长对应不同价格
* **错峰模式**（`off_peak=true`）可享受 **半价优惠**
* 生成失败或审核不通过不扣费

## 可用模型

| 场景     | 模型                                                                                                                              |
| ------ | ------------------------------------------------------------------------------------------------------------------------------- |
| 图生/首尾帧 | `viduq3-turbo`、`viduq3-pro`、`viduq2-pro-fast`、`viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`、`vidu2.0`（首尾帧不支持 `vidu1.5`） |
| 文生     | `viduq3-turbo`、`viduq3-pro`、`viduq2`、`viduq1`、`vidu2.0`、`vidu1.5`                                                               |
| 参考生    | `viduq2`、`viduq1`、`vidu2.0`、`vidu1.5`                                                                                           |
| 音效生成   | `audio1.0`                                                                                                                      |

## API 认证

所有接口统一使用 `/vidu` 路径前缀，认证方式：

```
Authorization: Bearer <HingNet AI Token>
```

## 快速上手

### 文生视频

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/text2video" \
  -H "Authorization: Bearer <HingNet AI Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "prompt": "海边日落，电影风格",
    "audio": true,
    "duration": 5,
    "resolution": "720p",
    "style": "general"
  }'
```

### 查询任务状态

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

## 实用技巧

| 技巧   | 说明                                         |
| ---- | ------------------------------------------ |
| 节省费用 | 使用 `off_peak=true` 开启错峰模式                  |
| 添加水印 | 通过 `watermark`、`wm_position`、`wm_url` 参数配置 |
| 选择风格 | `style` 支持 `general`（通用）和 `anime`（动漫）      |

## 页面导航

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

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

  <Card title="视频替换" href="/vidu/video-replace" icon="scissors" />

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

  <Card title="电商一键成片" href="/vidu/ad-one-click" icon="sparkles" />

  <Card title="可控文生音效" href="/vidu/timing2audio" icon="music" />
</CardGroup>