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

# 视频生成

> 常见调用示例与要点（非 API 规范）

说明

* 路径：`/vidu/ent/v2/{action}`，其中 `action` 为以下之一：
  * `text2video`（文生视频）
  * `img2video`（图生视频，`images` 仅 1 张）
  * `start-end2video`（首帧+末帧，`images` 恰好 2 张）
  * `reference2video`（参考生视频，`images` 1-7 张，需 `prompt`）
* 模型名：完全按 VIDU 官方文档填写：
  * 图生 / 首尾帧：`viduq2-pro-fast`、`viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`、`vidu2.0`、`vidu1.5`。
  * 文生 / 参考生：`viduq2`、`viduq1`、`vidu2.0`、`vidu1.5`。
* 错峰：`off_peak=true` 自动半价（积分减半并向上取整），平台会在内部计费 SKU 上添加 `-offpeak` 后缀。
* 水印：`watermark`、`wm_position`、`wm_url` 可选。

常用参数总览

* 通用字段：
  * `model`：模型名称，见上文“模型名”说明；
  * `duration`：视频时长（秒），不同模型允许的取值不同，未传则按模型默认值补全；
  * `resolution`：分辨率，常用 `540p` / `720p` / `1080p`；
  * `movement_amplitude`：镜头运动幅度，`auto`/`small`/`medium`/`large`；
  * `off_peak`：是否开启错峰模式（true 时价格更低，但生成时间可能延迟）；
  * `watermark` / `wm_position` / `wm_url`：水印开关、位置、内容；
  * `callback_url`：可选回调地址，任务状态变化时 Vidu 会 POST 回调。
* 图像字段：
  * `images`：用于 `img2video` / `reference2video` / `start-end2video`，要求：
    * `img2video`：必须 1 张；
    * `start-end2video`：必须 2 张（首帧 + 尾帧）；
    * `reference2video`：1–7 张（参考主体图片）。
* 文本字段：
  * `prompt`：文生/参考生视频的提示词（必填：`text2video`、`reference2video`，最长 2000 字符）；
  * `style`：仅文生视频使用，`general`（通用） / `anime`（动漫）。

示例：文生视频（text2video）

```bash theme={null}
curl --request POST \
  --url https://models.kapon.cloud/vidu/ent/v2/text2video \
  --header 'Authorization: Bearer <kapon Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq2-turbo",
  "prompt": "A girl runs toward the camera and winks with a smile.",
  "duration": 4,
  "resolution": "720p",
  "style": "general",
  "off_peak": false
}'
```

示例：图生视频（img2video）

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

示例：首尾帧（start-end2video）

```bash theme={null}
curl --request POST \
  --url https://models.kapon.cloud/vidu/ent/v2/start-end2video \
  --header 'Authorization: Bearer <kapon Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq2-pro",
  "images": [
    "https://your.cdn.com/start.png",
    "https://your.cdn.com/end.png"
  ],
  "duration": 5,
  "resolution": "1080p"
}'
```

示例：参考生视频（reference2video）

```bash theme={null}
curl --request POST \
  --url https://models.kapon.cloud/vidu/ent/v2/reference2video \
  --header 'Authorization: Bearer <kapon Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq1",
  "images": [
    "https://your.cdn.com/ref-1.jpg",
    "https://your.cdn.com/ref-2.jpg"
  ],
  "prompt": "A mouse runs toward the camera, smiling and blinking.",
  "duration": 5,
  "resolution": "1080p",
  "watermark": false
}'
```

创建成功返回（示例）

```json theme={null}
{
  "task_id": "176843862716480",
  "state": "created"
}
```

小贴士

* 文本提示词：`text2video` 与 `reference2video` 推荐传 `prompt`（最长 2000 字符）。
* 图片数量：`img2video` 必须 1 张；`start-end2video` 必须 2 张；`reference2video` 支持 1–7 张。
* 分辨率与时长：不同模型可选项不同，未填写时系统会自动补默认值（与官方一致）。
  * Q2 系列一般支持 1–10 秒，`540p/720p/1080p`；
  * `vidu2.0`、`vidu1.5` 等老模型在 4s/8s 档有不同限制，可参考官方表格。
* 异步任务：创建成功仅代表任务进入队列，实际产出视频需要稍后通过：
  * 查询接口：`GET /vidu/ent/v2/tasks/{task_id}/creations`；
  * 或回调：在创建时设置 `callback_url` 。