Vega Video 1.5 Lite
← 返回 Vega Video 概览,查看版本对比与选型。
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcVideoTask国际站 API 文档: CreateAigcVideoTask
Vega Video 1.5 Lite(1.5-lite)是 Vega Lite 系列的新版本,兼顾生成质量、速度与成本。它支持文生视频、首帧 / 尾帧 / 首尾帧生成,以及图片、视频、音频混合输入的多模态参考生成;输出最高 4K、单条 2~30 秒,也可使用 -1 让模型智能决定时长,并支持同时生成音频。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | wand-vega-video |
| ModelVersion | 1.5-lite |
| 分辨率 | 480P / 720P / 1080P / 2K / 4K |
| 比例 | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive |
| 时长 | 2~30 秒,或 -1(智能时长) |
| 输出声音 | 支持(AudioGeneration: Enabled) |
输入规格
| 输入类型 | 数量与时长 | 单文件大小 |
|---|---|---|
| 首帧 / 尾帧图片 | 各 1 张 | 20MB 以下 |
| 参考图片 | 最多 10 张 | 每张 20MB 以下 |
| 参考视频 | 最多 5 段,总时长 15 秒 以下 | 每段 100MB 以下 |
| 参考音频 | 最多 5 段,总时长 15 秒 以下 | 每段 15MB 以下 |
参考输入通过 FileInfos 传入,并用 Usage 标记用途:FirstFrame、LastFrame 或 Reference。音频参考需与图片或视频素材一起使用。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
SubAppId | 必填 | Integer | VOD 应用 ID |
ModelName | 必填 | String | 固定值 wand-vega-video |
ModelVersion | 必填 | String | 固定值 1.5-lite |
Prompt | 条件必填 | String | 生成或编辑指令;FileInfos 为空时必填 |
FileInfos.N | 可选 | Array | 图片、视频或音频参考素材;Usage 为 FirstFrame / LastFrame / Reference |
OutputConfig.Resolution | 可选 | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | 可选 | Float | 2~30,或 -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 |
ExtInfo | 可选 | String | JSON 编码字符串,用于传递 WandVegaParameters |
请求示例
文生视频
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "A woman walks through a rain-soaked neon street, cinematic camera movement and natural motion.",
"OutputConfig": {
"Resolution": "1080P",
"Duration": 10,
"AspectRatio": "16:9",
"AudioGeneration": "Enabled",
"StorageMode": "Temporary"
}
}首尾帧生成
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "Create a smooth, cinematic transition between the two scenes.",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "FirstFrame",
"Url": "https://<cdn>/first.png"
},
{
"Type": "Url",
"Category": "Image",
"Usage": "LastFrame",
"Url": "https://<cdn>/last.png"
}
],
"OutputConfig": {
"Resolution": "1080P",
"Duration": 8,
"AspectRatio": "16:9",
"StorageMode": "Temporary"
}
}多模态参考生成
{
"SubAppId": 123456789,
"ModelName": "wand-vega-video",
"ModelVersion": "1.5-lite",
"Prompt": "Keep the character identity and follow the reference video's camera rhythm.",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Usage": "Reference",
"Url": "https://<cdn>/character.png"
},
{
"Type": "Url",
"Category": "Video",
"Usage": "Reference",
"Url": "https://<cdn>/camera-reference.mp4"
},
{
"Type": "Url",
"Category": "Audio",
"Usage": "Reference",
"Url": "https://<cdn>/music-reference.mp3"
}
],
"OutputConfig": {
"Resolution": "2K",
"Duration": -1,
"AspectRatio": "adaptive",
"AudioGeneration": "Enabled",
"StorageMode": "Temporary"
}
}响应与结果查询
生成请求返回 TaskId。可通过 DescribeTaskDetail 查询任务;AigcVideoTask.Status=FINISH 且 ErrCode=0 表示生成成功,视频地址位于 AigcVideoTask.Output.FileInfos.FileUrl。
{
"SubAppId": 123456789,
"TaskId": "<task-id>"
}特殊设置
ExtInfo (WandVegaParameters)
Lite 通过 ExtInfo 的 WandVegaParameters 键接收模型专用选项。内层参数对象需先序列化成 JSON 字符串,再放入 ExtInfo 并再次序列化。
| 参数 | 类型 | 值 / 行为 |
|---|---|---|
EnhancePromptMode | String | auto / enable / disable。省略或为 auto 时按 enable 处理 |
ReturnVegaUsage | Boolean | 是否在结果中返回 Vega 用量,默认 false |
ModerationMode | String | Moderation_L1 / Moderation_L2 |
与 1.0 Lite 的差异
1.5-lite 不支持 GenerateMode 与 VideoQualityMode,这两个参数仅 1.0 Lite 可用。
import json
ext_info = json.dumps({
"WandVegaParameters": json.dumps({
"EnhancePromptMode": "enable",
"ReturnVegaUsage": True,
"ModerationMode": "Moderation_L1",
})
})永久保存
将 OutputConfig.StorageMode 设为 Permanent,即可把结果保存为 VOD 媒体资产;可同时设置 MediaName。