Vega Video 1.0 Lite
← 返回 Vega Video 概览,查看版本对比与选型。
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vega Video 1.0 Lite(1.0-lite)是兼顾成本与速度的视频生成版本:支持文生视频、首帧 / 尾帧 / 首尾帧生成,以及图片、视频、音频混合输入(合计最多 12 个)的多模态参考生成。它输出 480P~4K、单条 4~15 秒,默认开启提示词优化,并可通过 GenerateMode / VideoQualityMode 选择快速或电影质感模式。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.0-lite |
| 分辨率 | 480P / 768P / 1080P / 2K / 4K |
| 比例 | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
| 时长 | 4~15 秒 |
| 输出声音 | 支持(AudioGeneration: Enabled) |
| 护栏解除支持 | 支持 |
输入规格
1.0 Lite 参考图片
| 项目 | 规格 |
|---|---|
| 参考图片数 | 最多 9 张 |
| 单个图片文件大小 | 30MB 以下 |
| 图片宽度 / 高度 | 各为 256~5760px |
| 图片比例 | 首帧 / 尾帧为 0.4~2.5 |
| 图片格式 | JPEG / PNG / WEBP / HEIC / HEIF |
| 首帧 / 尾帧 | 各 1 张 |
| 混合输入总数 | 图片 / 视频 / 音频合计最多 12 个 |
1.0 Lite 参考视频 / 音频
| 项目 | 规格 |
|---|---|
| 参考视频数 | 最多 3 个 |
| 单个视频文件大小 | 50MB 以下 |
| 视频时长 | 单个 2~15 秒,合计 15 秒 以下 |
| 视频宽度 / 高度 | 各为 256~5760px,宽/高比例 0.4~2.5 |
| 视频格式 / 编码 | H.264 / H.265,内部音频 AAC / MP3 |
| 视频分辨率 / 总像素 | 适用上述宽度 / 高度条件 |
| 视频帧率 | — |
| 参考音频数 | 最多 3 个 |
| 单个音频文件大小 | 15MB 以下 |
| 音频时长 | 单个 2~15 秒,合计 15 秒 以下 |
| 音频格式 | WAV / MP3 |
| 音频输入条件 | 须与 1 个 以上的图片或视频一同输入。不支持音频单独输入 |
Lite 的容量限制按单个文件计算,没有另外的合计容量限制。提示词最多 7,000 字。首帧 / 尾帧模式采用输入图片的比例,参考生成支持 adaptive。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 wand-vega-video |
ModelVersion | 必填 | String | 1.0-lite |
Prompt | 条件必填 | String | 最多 7000 字。FileInfos 为空时必填 |
FileInfos.N | 可选 | Array | 参考输入。Usage 为 FirstFrame(首帧) / LastFrame(尾帧) / Reference(参考) |
OutputConfig.Resolution | 可选 | String | 480P / 768P / 1080P / 2K / 4K |
OutputConfig.Duration | 可选 | Integer | 4~15 |
OutputConfig.AspectRatio | 可选 | String | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
OutputConfig.StorageMode | 可选 | String | Temporary(7 天) / Permanent(VOD 媒体资产永久保存) |
OutputConfig.MediaName | 可选 | String | StorageMode=Permanent 时显示的媒体名称 |
OutputConfig.AudioGeneration | 可选 | String | Enabled / Disabled |
ExtInfo | 可选 | String | 2 中的 JSON 编码字符串。用于传递下列附加参数(WandVegaParameters)。 |
首帧推荐写法
首帧用 FileInfos.Usage="FirstFrame" 指定,尾帧在单独的项目中指定 Usage="LastFrame"。LastFrameUrl / LastFrameFileId 为兼容历史调用而保留,但新实现建议使用 Usage="LastFrame"。
输出分辨率
通过 OutputConfig.Resolution 与 AspectRatio 指定。以 16:9 为基准的输出尺寸如下。
| Resolution | AspectRatio | 输出分辨率 |
|---|---|---|
480P | 16:9 | 864x480 |
768P | 16:9 | 1344x768 |
1080P | 16:9 | 1920x1080 |
2K | 16:9 | 2560x1440 |
4K | 16:9 | 3840x2160 |
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
OutputConfig.InputComplianceCheck | 可选 | String | 显式传入 Disabled 即解除输入审核。使用前请咨询销售负责人 |
OutputConfig.OutputComplianceCheck | 可选 | String | 显式传入 Disabled 即解除输出审核。使用前请咨询销售负责人 |
请求示例
文生视频
{
"SubAppId": 0,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"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": 0,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
}
],
"Prompt": "she slowly opens her eyes and looks into the distance",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}尾帧生成 (LastFrame)
指定 Usage="LastFrame" 则只固定尾帧,起点由模型自由确定。
{
"SubAppId": 0,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"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)
在 FileInfos 中同时放入 FirstFrame 与 LastFrame,即可自然衔接两帧。
{
"SubAppId": 0,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"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"
}
}多模态参考 (Reference)
同时放入图片、视频、音频来制作参考视频。图片用 Usage="Reference" 指定。
{
"SubAppId": 0,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/ref1.png"
},
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/ref2.png"
},
{
"Type": "Url",
"Category": "Video",
"Usage": "Reference",
"Url": "https://<cdn>/ref.mp4"
}
],
"Prompt": "blend the subjects naturally into the reference video environment",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 5,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}响应与结果查询
任务受理响应
受理生成请求时会返回 TaskId。可用该 ID 查询完成状态与产物。
{
"TaskId": "<task-id>",
"RequestId": "<request-id>"
}结果查询
以 3 秒 的间隔轮询 DescribeTaskDetail。Status 为 PROCESSING 时继续查询;为 FINISH 且 ErrCode=0 时表示成功;为 FAIL 时通过 Message 确认原因。
{
"SubAppId": 0,
"TaskId": "<task-id>"
}完成响应
默认的保存方式是有效期 7 天 的临时 URL。请在该期限内下载,或用 StorageMode=Permanent 保存。
{
"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 (WandVegaParameters)
Lite 通过 ExtInfo 的 WandVegaParameters 键接收模型专用选项。它是 2 中的 JSON 编码,内层对象需再包一层字符串。
| 参数 | 类型 | 值 / 行为 |
|---|---|---|
EnhancePromptMode | String | auto / enable / disable。省略或为 auto 时启用提示词优化 |
ReturnVegaUsage | Boolean | 请求返回使用量。默认值 false |
ModerationMode | String | Moderation_L1:基本审核,默认值。Moderation_L2:强化审核。与护栏解除无关 |
GenerateMode | String | Standard / Fast / StandardMovie |
VideoQualityMode | String | Standard / Fast / SuperFast。需一并指定 OutputConfig.Resolution |
Standard 用于常规生成,Fast 用于快速生成,StandardMovie 用于呈现自然的电影质感。
import json
ext_inner = {
"EnhancePromptMode": "disable",
"ReturnVegaUsage": True,
"GenerateMode": "Standard",
"VideoQualityMode": "Standard",
}
ext_info = json.dumps({
"WandVegaParameters": json.dumps(ext_inner)
})下面是关闭提示词优化并请求返回使用量的示例。
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.0-lite",
"Prompt": "A blue ceramic cup on a wooden table. A slow camera dolly forward, soft natural light.",
"OutputConfig": {
"StorageMode": "Temporary",
"Resolution": "480P",
"AspectRatio": "16:9",
"Duration": 4,
"AudioGeneration": "Disabled"
},
"ExtInfo": "{\"WandVegaParameters\":\"{\\\"EnhancePromptMode\\\":\\\"disable\\\",\\\"ReturnVegaUsage\\\":true}\"}"
}返回使用量后,AigcVideoTask.Output.Usage.CompletionTokens 是输出 token 数,AigcVideoTask.Output.Usage.TotalTokens 是含输入的总 token 数。
永久保存
若要把结果留存为 VOD 媒体资产,请将 OutputConfig.StorageMode 指定为 Permanent。此后即可与普通 VOD 媒体一样管理。
{
"OutputConfig": {
"StorageMode": "Permanent",
"MediaName": "wand-vega-video-lite-sample"
}
}护栏解除
可以分别设置输入与输出审核。
使用护栏解除参数前,须先联系销售负责人确认使用权限。即使在支持的引擎上,也只有显式传入相应参数时才会解除护栏。省略参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
OutputConfig.InputComplianceCheck | Disabled | 解除输入审核 |
OutputConfig.OutputComplianceCheck | Disabled | 解除输出审核 |
请把下列设置合并到现有的生成请求中。若要同时解除输入与输出审核,请一并传入两个字段。
{
"OutputConfig": {
"InputComplianceCheck": "Disabled",
"OutputComplianceCheck": "Disabled"
}
}