跳到内容

Vidu ​

更新时间

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Vidu 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频与多图参考生成(q3-ad 1~7 张,q3-drama 1~14 张)。q3-mix 支持多镜头组合,并提供数字人、唇形同步、特效模板,可同时生成音频。

基本信息 ​

项目值
ModelNameVidu
ModelVersionq3-ad / q3-drama / q3-mix / q3-turbo / q3-pro / q3 / q2-pro / q2 / q2-turbo
安全护栏解除支持支持

各版本支持规格 ​

版本分辨率比例时长
q3-ad720P / 1080P16:9 / 1:1 / 9:16—
q3-drama1080P16:9 / 9:16—
q3-ad———
q3-ad———
q3-ad———
q3-drama———
q3-drama———

输入条件 ​

版本条件
q3-ad参考图片:1–7 张
q3-drama参考图片:1–7 张
q3-adResolution: 720P
AspectRatio: 16:9
输出像素:1280×720
q3-adResolution: 1080P
AspectRatio: 1:1
输出像素:1440×1440
q3-adResolution: 720P
AspectRatio: 9:16
输出像素:720×1280
q3-dramaResolution: 1080P
AspectRatio: 16:9
输出像素:1920×1080
q3-dramaResolution: 1080P
AspectRatio: 9:16
输出像素:1080×1920

支持基于图片引用和已注册引用对象的视频生成。q3 系列支持自动镜头切换与音频同步生成。

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Vidu
ModelVersion选填Stringq3-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选填ObjectResolution / AspectRatio / EnableAudio
AdditionalParameters选填String承载模型专属选项的 JSON 字符串。seed 的传递格式请参考附加设置
SubjectInfos.N选填Array已注册的引用对象信息。Id / Name / VoiceId / ImageUrls / VideoUrls
SceneType选填Stringtemplate_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.EnablelnputComplianceCheckfalse输入审核解除
ExtraParameters.EnableOutputComplianceCheckfalse输出审核解除

将以下设置合并到现有的生成请求中。若要同时解除输入和输出审核,需一并传递这两个字段。

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 字以内。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages