Vega Video 1.0 Pro
← 返回 Vega Video 概览,查看版本对比与选型。
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vega Video 1.0 Pro(1.0-pro,另有 1.0-pro-fast / 1.0-pro-mini)用于视频生成:支持文生视频、首帧 / 尾帧 / 首尾帧生成,以及最多 9 张图片、3 个视频、3 个音频混合输入的多模态参考生成。它同样支持参考视频编辑与延长,输出 480P~4K、单条 4~15 秒,并可同时生成音频。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.0-pro / 1.0-pro-fast / 1.0-pro-mini |
| 分辨率 | 480P / 720P / 1080P / 2K / 4K |
| 比例 | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
| 时长 | 4~15 秒 |
| 输出声音 | 支持(AudioGeneration: Enabled) |
| 护栏解除支持 | 支持 |
输入规格
1.0 Pro 参考图片
| 项目 | 规格 |
|---|---|
| 参考图片数 | 最多 9 张 |
| 单个图片文件大小 | 小于 30MB |
| 图片宽度 / 高度 | 各为 300~6000px |
| 图片比例 | 宽/高 0.4~2.5 |
| 图片格式 | JPEG / PNG / WEBP / BMP / TIFF / GIF / HEIC / HEIF |
| 首帧 / 尾帧 | 各 1 张 |
| 混合输入总数 | 图片 / 视频 / 音频合计最多 12 个 |
1.0 Pro 参考视频 / 音频
| 项目 | 规格 |
|---|---|
| 参考视频数 | 最多 3 个 |
| 单个视频文件大小 | 50MB 以下 |
| 视频时长 | 单个 2~15 秒,合计 15 秒 以下 |
| 视频宽度 / 高度 | 各为 300~6000px,宽/高比例 0.4~2.5 |
| 视频格式 / 编码 | MP4 / MOV |
| 视频分辨率 / 总像素 | 480P / 720P / 1080P,409,600~2,086,876 像素 |
| 视频帧率 | 24~60fps |
| 参考音频数 | 最多 3 个 |
| 单个音频文件大小 | 15MB 以下 |
| 音频时长 | 单个 2~15 秒,合计 15 秒 以下 |
| 音频格式 | WAV / MP3 |
| 音频输入条件 | 须与 1 个 以上的图片或视频一同输入。不支持音频单独输入 |
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 wand-vega-video |
ModelVersion | 必填 | String | 1.0-pro / 1.0-pro-fast / 1.0-pro-mini |
Prompt | 条件必填 | String | FileInfos 为空时必填 |
FileInfos.N | 可选 | Array | 参考输入。 Type : String - 输入文件类型 - File : VOD 媒体文件 - Url : 可访问的 URL Category : String - 文件分类 - Image, Video, Audio FileId : String - 媒体文件 ID,Type 为 File 时有效 Url : String - 可访问的文件 URL,Type 为 Url 时有效 Usage 为 FirstFrame / LastFrame / Reference。 |
OutputConfig.Resolution | 可选 | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | 可选 | Float | 以秒为单位的数字,范围 4~15。-1 表示由模型自动决定时长。 |
OutputConfig.AspectRatio | 可选 | String | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
OutputConfig.StorageMode | 可选 | String | Temporary / Permanent(存储类型:临时存储 / 永久存储) |
OutputConfig.MediaName | 可选 | String | Permanent 时显示的媒体名称 |
OutputConfig.AudioGeneration | 可选 | String | Enabled / Disabled |
OutputConfig.LogoAdd | 可选 | String | Enabled / Disabled(是否使用 Logo 水印) |
Seed | 可选 | Integer | 模型种子。Seed 相同则结果相近 |
ExtInfo | 可选 | String | 2 中的 JSON 编码。向 AdditionalParameters / WandVegaParameters 传递附加选项 |
输出分辨率
通过 OutputConfig.Resolution 与 AspectRatio 指定。以 16:9 为基准的输出尺寸如下。
| Resolution | AspectRatio | 输出分辨率 |
|---|---|---|
480P | 16:9 | 854x480 |
720P | 16:9 | 1280x720 |
1080P | 16:9 | 1920x1080 |
2K | 16:9 | 2560x1440 |
4K | 16:9 | 3840x2160 |
480P 适用于 1.0-pro。
请求示例
文生视频
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "a calico cat sitting on a wooden windowsill, sunlight streaming in, gentle breeze",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}首帧生成 (FirstFrame)
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
}
],
"Prompt": "subtle camera dolly, calm mood",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}尾帧生成 (LastFrame)
使用 Usage="LastFrame",或为兼容历史调用而保留的 LastFrameUrl。
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"Prompt": "the scene settles on a quiet window at dusk",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}首帧/尾帧生成 (FirstFrame + LastFrame)
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
},
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"Prompt": "smooth transition between the two scenes",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}响应与结果查询
任务受理响应
{
"TaskId": "<task-id>",
"RequestId": "<request-id>"
}结果查询
{
"SubAppId": 123456789,
"TaskId": "<task-id>"
}完成响应
{
"AigcVideoTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
"ExpireTime": "2026-09-15T10:29:48Z",
"MetaData": {
"Width": 1920,
"Height": 1080,
"Duration": 5.07,
"Container": "mov,mp4,m4a",
"Bitrate": 9494850
}
}
]
}
}
}特殊设置
ExtInfo (AdditionalParameters)
Pro 的 ExtInfo 会根据选项使用 AdditionalParameters 或 WandVegaParameters 键。它是 2 中的 JSON 编码,内层对象需再包一层字符串。
- return_last_frame : 在结果中一并返回尾帧图片。
- bitrate_mode : 高画质模式
import json
ext_inner = {
# "return_last_frame": True, # 在结果中一并返回最后一帧图片
# "bitrate_mode": "high", # 高画质模式
}
ext_info = json.dumps({"AdditionalParameters": json.dumps(ext_inner)}, ensure_ascii=False)传参示例(获取尾帧):
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/ref.png"
}
],
"Prompt": "natural motion, cinematic",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"return_last_frame\\\":true}\"}"
}以 return_last_frame=true 调用时,Output.FileInfos 中会同时返回视频与尾帧图片。尾帧的 UsageType 为 last_frame_url。
任务类型选择
在 ExtInfo 内的 AdditionalParameters 中指定 omni_reference_task_type。
| 值 | 行为 | 输入与输出条件 |
|---|---|---|
auto | 根据输入素材与提示词自动判断任务类型 | 适用各版本的输入与输出规格 |
reference | 参考图片 / 视频 / 音频生成新视频 | 不因任务类型而附加比例 / 时长限制。仍适用各版本的基本规格 |
edit | 编辑原视频的画面或音频 | 参考视频 1 个 以上,视频时长 4~30 秒。OutputConfig.AspectRatio=adaptive、OutputConfig.Duration=-1 |
extend | 将原视频向前或向后延长 | 参考视频 1 个 以上。OutputConfig.AspectRatio=adaptive |
参考视频通过 FileInfos 的 Category=Video、Usage=Reference 传入。各版本的视频输入时长与文件限制也一并适用。
import json
ext_info = json.dumps({
"AdditionalParameters": json.dumps({
"omni_reference_task_type": "extend"
})
})模型选项 (WandVegaParameters)
| 参数 | 类型 | 值 / 行为 |
|---|---|---|
EnhancePromptMode | String | auto / enable / disable。Pro 在省略或为 auto 时按 disable 处理。enable 表示启用优化,disable 表示使用原始提示词 |
ModerationMode | String | Moderation_L1:基本审核,默认值。Moderation_L2:强化审核 |
ReturnVegaUsage | Boolean | 默认值 false。为 true 时在结果中返回使用量 |
Pro 与 Lite 的 EnhancePromptMode 默认行为不同。ModerationMode 是用于选择审核级别的选项,并非护栏解除选项。
import json
ext_info = json.dumps({
"WandVegaParameters": json.dumps({
"EnhancePromptMode": "enable",
"ModerationMode": "Moderation_L2",
"ReturnVegaUsage": True
})
})在生成请求的 ExtInfo 中传入 ext_info 字符串。同时使用 AdditionalParameters 与 WandVegaParameters 时,需先把各自做成 JSON 字符串,再放入同一个 ExtInfo 对象并重新序列化。
使用量响应中的 Usage.CompletionTokens 是输出 token 数,Usage.TotalTokens 是含输入的总 token 数。
Seed
给出相同的 Seed 值会生成相近的结果。若重新生成时需要稳定地对比结果,请固定 Seed。
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "a calico cat on a wooden windowsill",
"Seed": 12345,
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}真人实拍参考
真人实拍参考有两种接入方式,均仅 Pro 支持,Lite 不支持:
- 素材注册后引用(推荐):先用
CreateAigcMaterial把图片注册为素材,拿到AssetId后在FileInfos中以asset://<AssetId>引用。国内站的现实真人素材需先完成活体认证,完整步骤见真人素材接入;非真人素材与国际站素材见非真人与国际站素材接入。 - 素材组直接参考:不单独注册素材,直接在生视频请求中带上
asset_group_id,用法如下。
在 CreateAigcVideoTask 的 FileInfos 中放入图片 URL,并向 ExtInfo.AdditionalParameters 传入 asset_group_id。首次使用的组名称会自动生成。
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-pro",
"Prompt": "natural motion, soft light",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/person.jpg"
}
],
"OutputConfig": {
"Resolution": "720P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"ExtInfo": "{\"AdditionalParameters\":\"{\\\"asset_group_id\\\":\\\"<your-group-id>\\\"}\"}"
}素材组直接参考只需一次 CreateAigcVideoTask 即可完成。
永久保存
{
"OutputConfig": {
"StorageMode": "Permanent",
"MediaName": "wand-vega-video-pro-sample"
}
}对接设置
| 项目 | 设置依据 | 适用方法 |
|---|---|---|
| 真人实拍参考 | 素材注册后以 asset:// 引用,或素材组直接参考 | 国内站现实真人先走活体认证,见真人素材接入 |
| 音频 | 自有 / 已取得使用权的音源 | 作为参考音频输入,或先只生成视频再在编辑阶段合成 |
护栏解除
可以分别设置输入与输出审核。
使用护栏解除参数前,须先联系销售负责人确认使用权限。即使在支持的引擎上,也只有显式传入相应参数时才会解除护栏。省略参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
OutputConfig.InputComplianceCheck | Disabled | 解除输入审核 |
OutputConfig.OutputComplianceCheck | Disabled | 解除输出审核 |
请把下列设置合并到现有的生成请求中。若要同时解除输入与输出审核,请一并传入两个字段。
{
"OutputConfig": {
"InputComplianceCheck": "Disabled",
"OutputComplianceCheck": "Disabled"
}
}