跳到内容

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 让模型智能决定时长,并支持同时生成音频。

基本信息 ​

项目值
ModelNamewand-vega-video
ModelVersion1.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必填IntegerVOD 应用 ID
ModelName必填String固定值 wand-vega-video
ModelVersion必填String固定值 1.5-lite
Prompt条件必填String生成或编辑指令;FileInfos 为空时必填
FileInfos.N可选Array图片、视频或音频参考素材;Usage 为 FirstFrame / LastFrame / Reference
OutputConfig.Resolution可选String480P / 720P / 1080P / 2K / 4K
OutputConfig.Duration可选Float2~30,或 -1(智能时长)
OutputConfig.AspectRatio可选String21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.StorageMode可选StringTemporary / Permanent
OutputConfig.MediaName可选StringPermanent 时显示的媒体名称
OutputConfig.AudioGeneration可选StringEnabled / Disabled
ExtInfo可选StringJSON 编码字符串,用于传递 WandVegaParameters

请求示例 ​

文生视频 ​

json
{
  "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"
  }
}

首尾帧生成 ​

json
{
  "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"
  }
}

多模态参考生成 ​

json
{
  "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。

json
{
  "SubAppId": 123456789,
  "TaskId": "<task-id>"
}

特殊设置 ​

ExtInfo (WandVegaParameters) ​

Lite 通过 ExtInfo 的 WandVegaParameters 键接收模型专用选项。内层参数对象需先序列化成 JSON 字符串,再放入 ExtInfo 并再次序列化。

参数类型值 / 行为
EnhancePromptModeStringauto / enable / disable。省略或为 auto 时按 enable 处理
ReturnVegaUsageBoolean是否在结果中返回 Vega 用量,默认 false
ModerationModeStringModeration_L1 / Moderation_L2

与 1.0 Lite 的差异

1.5-lite 不支持 GenerateMode 与 VideoQualityMode,这两个参数仅 1.0 Lite 可用。

python
import json

ext_info = json.dumps({
    "WandVegaParameters": json.dumps({
        "EnhancePromptMode": "enable",
        "ReturnVegaUsage": True,
        "ModerationMode": "Moderation_L1",
    })
})

永久保存 ​

将 OutputConfig.StorageMode 设为 Permanent,即可把结果保存为 VOD 媒体资产;可同时设置 MediaName。

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