跳转到主要内容

​
(Vidu 视频)

通过 Vidu 系列模型将文本描述转化为高品质视频。支持音画直出、错峰模式以及自定义水印等高级功能。

​
快速开始

视频生成是异步操作，整个流程分为三步： 
1. 提交任务 → 获得 task_id
2. 轮询状态 → 等待 status 变为 completed 返回公网链接

​
📌 基础信息

  • 接口地址: POST /v1/video/generations
  • 认证方式: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
  • 内容类型: application/json

​
📥 请求参数 (Request Body)

参数名类型必选描述
modelstring是模型名称。可选：viduq3-turbo (快)、viduq3-pro (优)、viduq2、viduq1。
promptstring是视频文本描述（最大 5000 字符）。
durationinteger否时长(秒)。Q3系列: 1-16; Q2: 1-10; Q1: 固定 5。
seedinteger否随机种子。传 0 或不传则随机。
metadataobject否扩展配置对象。
└─ aspect_ratiostring否比例。默认 16:9。可选 9:16, 1:1 等 (3:4/4:3 仅限 Q2/Q3)。
└─ resolutionstring否分辨率。可选 540p, 720p, 1080p (Q1 仅支持 1080p)。
└─ audioboolean否音视频直出（含音效/台词）。仅 Q3 系列支持，默认 true。
└─ bgmboolean否自动添加背景音乐。默认 false。
└─ off_peakboolean否错峰模式。开启后积分消耗更低，48小时内生成。
└─ callback_urlstring是回调地址。用于异步接收任务状态通知。
└─ watermarkboolean否是否添加水印。

​
🚀 模型特性对比

模型名称核心优势时长范围分辨率支持
viduq3-pro顶级画质，生动立体1 - 16s540p / 720p / 1080p
viduq3-turbo极速生成，高性价比1 - 16s540p / 720p / 1080p
viduq2最新通用模型1 - 10s540p / 720p / 1080p
viduq1转场平滑，运镜稳定5s1080p

​
📤 响应结果 (Response)

状态码: 200 OK (任务已提交)
字段名类型描述
idstring任务唯一标识 ID。
task_idstring任务 ID（用于查询）。
statusstring任务状态（如 queued 排队中）。
progressinteger生成进度。
created_atinteger创建时间戳。

​
📝 请求示例

{
  "model": "viduq3-turbo",
  "prompt": "镜头拍摄一个女性坐在咖啡馆里，女人抬头看着窗外，镜头缓缓移动，画面呈现暖色调，氛围轻松惬意。",
  "duration": 7,
  "seed": 3,
  "metadata": {
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "audio": true,
    "bgm": false,
    "off_peak": false,
    "callback_url": "https://your-api.com/v1/callback/vidu"
  }
}