跳到内容

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 选择快速或电影质感模式。

基本信息 ​

项目值
ModelNamewand-vega-video
ModelVersion1.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必填String1.0-lite
Prompt条件必填String最多 7000 字。FileInfos 为空时必填
FileInfos.N可选Array参考输入。Usage 为 FirstFrame(首帧) / LastFrame(尾帧) / Reference(参考)
OutputConfig.Resolution可选String480P / 768P / 1080P / 2K / 4K
OutputConfig.Duration可选Integer4~15
OutputConfig.AspectRatio可选String21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.StorageMode可选StringTemporary(7 天) / Permanent(VOD 媒体资产永久保存)
OutputConfig.MediaName可选StringStorageMode=Permanent 时显示的媒体名称
OutputConfig.AudioGeneration可选StringEnabled / Disabled
ExtInfo可选String2 中的 JSON 编码字符串。用于传递下列附加参数(WandVegaParameters)。

首帧推荐写法

首帧用 FileInfos.Usage="FirstFrame" 指定,尾帧在单独的项目中指定 Usage="LastFrame"。LastFrameUrl / LastFrameFileId 为兼容历史调用而保留,但新实现建议使用 Usage="LastFrame"。

输出分辨率 ​

通过 OutputConfig.Resolution 与 AspectRatio 指定。以 16:9 为基准的输出尺寸如下。

ResolutionAspectRatio输出分辨率
480P16:9864x480
768P16:91344x768
1080P16:91920x1080
2K16:92560x1440
4K16:93840x2160
参数必填类型说明
OutputConfig.
InputComplianceCheck
可选String显式传入 Disabled 即解除输入审核。使用前请咨询销售负责人
OutputConfig.
OutputComplianceCheck
可选String显式传入 Disabled 即解除输出审核。使用前请咨询销售负责人

请求示例 ​

文生视频 ​

json
{
  "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) ​

将一张图片固定为首帧,并生成其后的内容。

json
{
  "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" 则只固定尾帧,起点由模型自由确定。

json
{
  "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,即可自然衔接两帧。

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

json
{
  "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 查询完成状态与产物。

json
{
  "TaskId": "<task-id>",
  "RequestId": "<request-id>"
}

结果查询 ​

以 3 秒 的间隔轮询 DescribeTaskDetail。Status 为 PROCESSING 时继续查询;为 FINISH 且 ErrCode=0 时表示成功;为 FAIL 时通过 Message 确认原因。

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

完成响应 ​

默认的保存方式是有效期 7 天 的临时 URL。请在该期限内下载,或用 StorageMode=Permanent 保存。

json
{
  "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 编码,内层对象需再包一层字符串。

参数类型值 / 行为
EnhancePromptModeStringauto / enable / disable。省略或为 auto 时启用提示词优化
ReturnVegaUsageBoolean请求返回使用量。默认值 false
ModerationModeStringModeration_L1:基本审核,默认值。Moderation_L2:强化审核。与护栏解除无关
GenerateModeStringStandard / Fast / StandardMovie
VideoQualityModeStringStandard / Fast / SuperFast。需一并指定 OutputConfig.Resolution

Standard 用于常规生成,Fast 用于快速生成,StandardMovie 用于呈现自然的电影质感。

python
import json

ext_inner = {
    "EnhancePromptMode": "disable",
    "ReturnVegaUsage": True,
    "GenerateMode": "Standard",
    "VideoQualityMode": "Standard",
}
ext_info = json.dumps({
    "WandVegaParameters": json.dumps(ext_inner)
})

下面是关闭提示词优化并请求返回使用量的示例。

json
{
  "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 媒体一样管理。

json
{
  "OutputConfig": {
    "StorageMode": "Permanent",
    "MediaName": "wand-vega-video-lite-sample"
  }
}

护栏解除 ​

可以分别设置输入与输出审核。

使用护栏解除参数前,须先联系销售负责人确认使用权限。即使在支持的引擎上,也只有显式传入相应参数时才会解除护栏。省略参数则不会解除。

参数解除值适用对象
OutputConfig.InputComplianceCheckDisabled解除输入审核
OutputConfig.OutputComplianceCheckDisabled解除输出审核

请把下列设置合并到现有的生成请求中。若要同时解除输入与输出审核,请一并传入两个字段。

json
{
  "OutputConfig": {
    "InputComplianceCheck": "Disabled",
    "OutputComplianceCheck": "Disabled"
  }
}

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