Vidu参考生视频API
更新时间 2026-10-10 18:42:08
最近更新时间: 2026-10-10 18:42:08
本文介绍ViduQ3 系列参考生视频调用API。
模型简介
ViduQ3 系列是 Vidu 新一代参考生视频模型家族，包含 viduq3‑drama、viduq3‑ad、viduq3‑mix、viduq3‑turbo、viduq3 五个子模型，全部支持智能切镜、音画同出（人声 + 音效），支持 3‑16 秒视频输出，最高支持 1080p 分辨率。
支持的模型
| 模型名称 | 模型说明 | 适用场景 | 支持主体调用 |
|---|---|---|---|
| viduq3 | Q3 标准版 | 人物叙事、剧情短片 | 暂不支持 |
| viduq3‑turbo | Q3 极速版 | 短视频快速产出、批量生成 | 暂不支持 |
| viduq3‑mix | Q3 均衡版 | 质感向内容、创意短片 | 不支持 |
| viduq3‑drama | Q3 剧情版 | 短剧片段、故事向视频 | 不支持 |
| viduq3‑ad | Q3 广告版 | 商业广告、产品宣传短片 | 不支持 |
调用流程
接口采用异步任务模式，分两步执行：
step1：调用创建任务接口，成功返回task_id
step2：调用查询任务接口查询对应task_id，直到state值为success，获取生成视频url
接口调用模式
主体模式
平台暂不支持该模式
非主体模式
images：直接传入参考图片数组，所有 Q3 子模型均支持
创建任务接口详情
http调用
请求方式：POST
请求路径：https://ai.ctaigw.cn/v1/reference2video
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Token ${YOUR_APP_KEY} |
非主体调用
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型调用名称或模型ID |
| images | array | 是 | 参考图片数组；1‑7 张； URL/base64；png/jpeg/jpg/webp； 尺寸≥128*128；比例限制 1:4~4:1 |
| prompt | string | 是 | 生成提示词，最大 2000 字符 |
| audio | bool | 可选 | 音视频直出开关；默认 true |
| duration | integer | 可选 | 视频时长，默认 5s；取值 3‑16 |
| seed | integer | 可选 | 随机种子；0 / 不传使用随机值 |
| aspect_ratio | string | 可选 | 画面比例，默认 16:9；可选16:9/9:16/1:1 |
| resolution | string | 可选 | 分辨率 - viduq3‑mix：720p /1080p - viduq3‑turbo/viduq3：540p/720p/1080p - viduq3‑drama/viduq3‑ad：720p/1080p |
| payload | string | 可选 | 透传字符串，最大 1048576 字符 |
| watermark | bool | 可选 | 水印开关，默认 false |
| wm_position | integer | 可选 | 水印位置；1 左上、2 右上、3 右下、4 左下；默认 3 |
| wm_url | string | 可选 | 自定义水印图片 URL |
| meta_data | string | 可选 | JSON 字符串元数据透传 |
响应参数
| 字段 | 类型 | 描述 |
|---|---|---|
| task_id | string | 任务唯一 ID |
| state | string | 处理状态 可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败 |
| model | string | 调用模型名称 |
| prompt | string | 入参提示词 |
| images | array | 参考图片数组 |
| videos | array | Q3 系列为空 |
| duration | integer | 视频时长 |
| seed | integer | 随机种子 |
| aspect_ratio | string | 画面比例 |
| resolution | string | 输出分辨率 |
| audio | bool | 音视频直出开关 |
| payload | string | 透传参数 |
| watermark | bool | 水印开关 |
| created_at | string | 任务创建时间 ISO8601 |
请求/响应示例
非主体调用示例
请求
curl -X POST https://ai.ctaigw.cn/v1/reference2video \
-H "Content-Type: application/json" \
-H "Authorization: Token ${YOUR_API_KEY}" \
-d '{
"model": "viduq3‑ad",
"images": ["https://aaaa.ctyun.cn/product‑1.jpg","https://aaaa.ctyun.cn/product‑2.jpg"],
"prompt": "产品放置高级简约桌面，商业光影，镜头缓慢环绕展示产品细节",
"duration": 6,
"aspect_ratio": "9:16",
"resolution": "1080p"
}'响应
{
"task_id": "tsk‑xxxxxx",
"state": "created",
"model": "viduq3‑ad",
"images": ["https://aaaa.ctyun.cn/product‑1.jpg","https://aaaa.ctyun.cn/product‑2.jpg"],
"prompt": "产品放置高级简约桌面，商业光影，镜头缓慢环绕展示产品细节",
"duration": 6,
"seed": 67890,
"aspect_ratio": "9:16",
"resolution": "1080p",
"bgm": false,
"audio": true,
"payload": "",
"credits": 25,
"watermark": false,
"created_at": "2026‑09‑06T02:15:00.456Z"
}
