视频生成 - Rivus AI 用户文档

说明

路径：/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）

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）

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）

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）

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
}'

创建成功返回（示例）

{
  "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 。

Vidu