Vidu
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vidu 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频与多图参考生成(q3-ad 1~7 张,q3-drama 1~14 张)。q3-mix 支持多镜头组合,并提供数字人、唇形同步、特效模板,可同时生成音频。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Vidu |
| ModelVersion | q3-ad / q3-drama / q3-mix / q3-turbo / q3-pro / q3 / q2-pro / q2 / q2-turbo |
| 安全护栏解除支持 | 支持 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 时长 |
|---|---|---|---|
q3-ad | 720P / 1080P | 16:9 / 1:1 / 9:16 | — |
q3-drama | 1080P | 16:9 / 9:16 | — |
q3-ad | — | — | — |
q3-ad | — | — | — |
q3-ad | — | — | — |
q3-drama | — | — | — |
q3-drama | — | — | — |
输入条件
| 版本 | 条件 |
|---|---|
q3-ad | 参考图片:1–7 张 |
q3-drama | 参考图片:1–7 张 |
q3-ad | Resolution: 720PAspectRatio: 16:9输出像素: 1280×720 |
q3-ad | Resolution: 1080PAspectRatio: 1:1输出像素: 1440×1440 |
q3-ad | Resolution: 720PAspectRatio: 9:16输出像素: 720×1280 |
q3-drama | Resolution: 1080PAspectRatio: 16:9输出像素: 1920×1080 |
q3-drama | Resolution: 1080PAspectRatio: 9:16输出像素: 1080×1920 |
支持基于图片引用和已注册引用对象的视频生成。q3 系列支持自动镜头切换与音频同步生成。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Vidu |
ModelVersion | 选填 | String | q3-ad / q3-drama / q3-mix / q3-turbo / q3-pro / q3 / q2-pro / q2 / q2-turbo |
Prompt | 必填 | String | 生成提示词。文本输入模式最多 2000 字 |
NegativePrompt | 选填 | String | 结果中需要排除的元素。适用于支持的模型 |
EnhancePrompt | 选填 | Boolean | 提示词自动校正。默认值 false |
ImageUrl | 选填 | String | 首帧图片 URL。需可从外部访问且不超过 10MB |
LastImageUrl | 选填 | String | 尾帧图片 URL。需与 ImageUrl 一起使用 |
ImageInfos.N | 选填 | Array | 参考图片数组。如 ImageUrl / ReferenceType 等 |
Duration | 选填 | Integer | 生成时长(秒)。仅按各模型允许值生效 |
ExtraParameters | 选填 | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | 选填 | String | 承载模型专属选项的 JSON 字符串。seed 的传递格式请参考附加设置 |
SubjectInfos.N | 选填 | Array | 已注册的引用对象信息。Id / Name / VoiceId / ImageUrls / VideoUrls |
SceneType | 选填 | String | template_effect(特效模板) |
ExtraParameters.EnablelnputComplianceCheck | 选填 | Boolean | 显式传递 false 则解除输入审核。使用前请咨询商务经理 |
ExtraParameters.EnableOutputComplianceCheck | 选填 | Boolean | 显式传递 false 则解除输出审核。使用前请咨询商务经理 |
请求示例
text-to-video
json
{
"ModelName": "Vidu",
"ModelVersion": "q3-pro",
"Prompt": "a paper boat drifting down a rainy street, warm lamplight",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}响应示例
json
{
"Response": {
"Status": "DONE",
"ErrCode": "",
"Message": "ok",
"Resolution": "1280x720",
"VideoUrls": [
"https://example.com/output/vidu.mp4"
],
"RequestId": "7c43c2f7-ff98-45c4-9ac5-5742367c1a21"
}
}特殊设置
安全护栏解除
可分别设置输入审核与输出审核。
如需使用安全护栏解除参数,必须先联系商务经理确认使用权限。即使是在支持的引擎上,也只有显式传递该参数时才会应用安全护栏解除。省略该参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | 输入审核解除 |
ExtraParameters.EnableOutputComplianceCheck | false | 输出审核解除 |
将以下设置合并到现有的生成请求中。若要同时解除输入和输出审核,需一并传递这两个字段。
json
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}各版本支持能力
| 版本 | 特点 |
|---|---|
q3-mix | 画面完成度高,支持自动镜头切换、音频同步生成。仅限引用生成 |
q3-turbo | 自动镜头切换、音频同步生成,生成速度最快 |
q3-pro | 含音频的高质量结果 |
q3 | 自动镜头切换、音频同步生成、多机位场景构成 |
q2-pro | 支持参考视频、视频编辑、视频替换 |
q2 / q2-turbo | 动态运动与细节表现 |
支持模式
| 模式 | 说明 | 支持版本 |
|---|---|---|
| text-to-video | 仅通过提示词生成。5000 字以内 | q3-turbo / q3-pro / q2 |
| image-to-video | 将图片 1 张 用作首帧 | q3-turbo / q3-pro / q2-pro / q2-turbo |
| 首 / 尾帧 | 将图片 2 张 用作首帧与尾帧 | q3-turbo / q3-pro / q2-pro / q2-turbo |
| 引用生成(普通图片) | 用多张图片保持同一对象 | q3-ad / q3-drama / q3-mix / q3-turbo / q3 / q2-pro / q2 |
| 引用生成(引用对象) | 创建引用对象 ID 并通过 @参考对象id 引用 | q3-turbo / q3 / q2-pro / q2 (视频引用对象仅 q2-pro) |
参考图片生成
在 ImageInfos.ImageUrl 中指定参考图片。
json
{
"ModelName": "Vidu",
"ModelVersion": "q3-ad",
"Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
"ImageInfos": [
{
"ImageUrl": "https://example.com/reference.jpg"
}
],
"Duration": 3,
"ExtraParameters": {
"Resolution": "720P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-seoul",
"CosBucketPath": "/aigc/video/"
},
"Operator": "app"
}json
{
"ModelName": "Vidu",
"ModelVersion": "q3-drama",
"Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
"ImageInfos": [
{
"ImageUrl": "https://example.com/reference.jpg"
}
],
"Duration": 12,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-seoul",
"CosBucketPath": "/aigc/video/"
},
"Operator": "app"
}附加选项
时长范围
q3-ad为 3–16 秒。q3-drama为 8–12 秒。参考图片通过 ImageInfos.ImageUrl 最多输入 7 张。q2 系列为 1–10 秒。Prompt 需在 2000 字以内。