跳到内容

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 秒,并可同时生成音频。

基本信息 ​

项目值
ModelNamewand-vega-video
ModelVersion1.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必填String1.0-pro / 1.0-pro-fast / 1.0-pro-mini
Prompt条件必填StringFileInfos 为空时必填
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可选String480P / 720P / 1080P / 2K / 4K
OutputConfig.Duration可选Float以秒为单位的数字,范围 4~15。-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
OutputConfig.LogoAdd可选StringEnabled / Disabled(是否使用 Logo 水印)
Seed可选Integer模型种子。Seed 相同则结果相近
ExtInfo可选String2 中的 JSON 编码。向 AdditionalParameters / WandVegaParameters 传递附加选项

输出分辨率 ​

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

ResolutionAspectRatio输出分辨率
480P16:9854x480
720P16:91280x720
1080P16:91920x1080
2K16:92560x1440
4K16:93840x2160

480P 适用于 1.0-pro。

请求示例 ​

文生视频 ​

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

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

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

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

响应与结果查询 ​

任务受理响应 ​

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

结果查询 ​

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

完成响应 ​

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 (AdditionalParameters) ​

Pro 的 ExtInfo 会根据选项使用 AdditionalParameters 或 WandVegaParameters 键。它是 2 中的 JSON 编码,内层对象需再包一层字符串。

  • return_last_frame : 在结果中一并返回尾帧图片。
  • bitrate_mode : 高画质模式
python
import json
ext_inner = {
    # "return_last_frame": True,   # 在结果中一并返回最后一帧图片
    # "bitrate_mode": "high",      # 高画质模式
}
ext_info = json.dumps({"AdditionalParameters": json.dumps(ext_inner)}, ensure_ascii=False)

传参示例(获取尾帧):

json
{
  "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 传入。各版本的视频输入时长与文件限制也一并适用。

python
import json

ext_info = json.dumps({
    "AdditionalParameters": json.dumps({
        "omni_reference_task_type": "extend"
    })
})

模型选项 (WandVegaParameters) ​

参数类型值 / 行为
EnhancePromptModeStringauto / enable / disable。Pro 在省略或为 auto 时按 disable 处理。enable 表示启用优化,disable 表示使用原始提示词
ModerationModeStringModeration_L1:基本审核,默认值。Moderation_L2:强化审核
ReturnVegaUsageBoolean默认值 false。为 true 时在结果中返回使用量

Pro 与 Lite 的 EnhancePromptMode 默认行为不同。ModerationMode 是用于选择审核级别的选项,并非护栏解除选项。

python
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。

json
{
  "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。首次使用的组名称会自动生成。

json
{
  "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 即可完成。

永久保存 ​

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

对接设置 ​

项目设置依据适用方法
真人实拍参考素材注册后以 asset:// 引用,或素材组直接参考国内站现实真人先走活体认证,见真人素材接入
音频自有 / 已取得使用权的音源作为参考音频输入,或先只生成视频再在编辑阶段合成

护栏解除 ​

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

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

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

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

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

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