跳到内容

Vega Video HOT ​

更新时间

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Vega Video 是 WAND 自研的视频生成模型,支持文生视频、首帧 / 尾帧 / 首尾帧生视频,以及图片、视频、音频混合输入的多模态参考生成,并可同时生成音频。提供 1.5-pro、1.0-pro、1.0-lite 三个版本,分辨率与宽高比在 ExtraParameters 中指定,时长在 Duration 中指定。

基本信息 ​

项目值
ModelNamewand-vega-video
ModelVersion1.5-pro / 1.0-pro / 1.0-lite
输入文本 / 首/尾帧 / 参考图片 / 视频
结果查询DescribeAigcVideoTask
结果保存StoreCosParam 中指定的 COS 存储桶
护栏解除支持支持

各版本支持规格 ​

版本分辨率比例时长
1.5-pro720P / 1080P / 2K16:9 / 9:164 秒 / 8 秒
1.0-pro720P / 1080P16:9 / 1:14 秒 / 8 秒
1.0-lite480P / 768P / 1080P16:9 / 9:16 / 1:14 秒 / 8 秒

表格为下方请求示例的输出配置。横向输出在 Pro 720P 下为 1280×720,在 Pro 1080P 下为 1920×1080,在 Lite 480P 下为 864×480。Lite 的正方形首帧示例以 1080×1080 输出。Duration 为请求时长,结果文件的播放时长可能因编码单位而略有差异。

分辨率为输出等级。2K / 9:16 可能以 1440×2560 输出,1080P / 1:1 可能以 1440×1440 输出,768P / 9:16 可能以 768×1344 输出。请根据输入方式与编码对齐情况确认实际像素尺寸。Lite 的分辨率值请勿使用 720P,而应使用 768P。

1.5 Pro ​

1.5 Pro 参考图片 ​

项目规格
参考图片数量建议 9 张 以下
单个图片文件容量小于 30MB
图片宽 / 高各 300~6000px
图片比例宽/高 0.4~2.5
图片格式JPEG / PNG
首 / 尾帧各 1 张
参考图片字段ImageInfos.N.ImageUrl

1.0 Pro ​

1.0 Pro 参考图片 ​

项目规格
参考图片数量最大 9 张
单个图片文件容量小于 30MB
图片宽 / 高各 300~6000px
图片比例宽/高 0.4~2.5
图片格式JPEG / PNG
首 / 尾帧各 1 张
参考图片字段ImageInfos.N.ImageUrl

1.0 Lite ​

1.0 Lite 不支持素材组直接引用方式。

1.0 Lite 参考图片 ​

项目规格
参考图片数量最大 9 张
单个图片文件容量30MB 以下
图片宽 / 高各 256~5760px
图片比例首 / 尾帧为 0.4~2.5
图片格式JPEG / PNG
首 / 尾帧各 1 张
参考图片字段ImageInfos.N.ImageUrl

1.5-pro 的建议张数以 MPS 对接配置为准,不代表模型的最大张数。使用图片 30 张 的配置,请遵循 VOD WAND-Vega-Video 的 FileInfos 输入规格。

私有 COS 对象请使用有效的签名 URL。签名 URL 的有效期需保持到输入下载完成为止。

请求参数 ​

参数必填类型说明
ModelName必填Stringwand-vega-video
ModelVersion必填String1.5-pro / 1.0-pro / 1.0-lite
Prompt必填String描述场景、运动与参考媒体作用的指令
EnhancePrompt选填BooleanPrompt 自动校正。示例使用 false
Duration选填Integer要生成的视频时长(秒)。请指定与版本及输入方式匹配的值
ImageUrl选填String首帧图片 URL
LastImageUrl选填String尾帧图片 URL。与 ImageUrl 一同使用
ImageInfos.N.ImageUrl选填String参考图片 URL
VideoInfos.N.VideoUrl选填String参考视频 URL
ExtraParameters.
Resolution
选填String输出分辨率
ExtraParameters.
AspectRatio
选填String输出宽高比
ExtraParameters.
EnableAudio
选填Boolean视频音频生成配置。示例使用 true
StoreCosParam选填Object结果保存位置。CosBucketName / CosBucketRegion / CosBucketPath
ExtraParameters.
EnablelnputComplianceCheck
选填Boolean显式传入 false 则解除输入审核。使用前请咨询商务负责人
ExtraParameters.
EnableOutputComplianceCheck
选填Boolean显式传入 false 则解除输出审核。使用前请咨询商务负责人

请求示例 ​

1.5 Pro 请求示例 ​

json
{
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.5-pro",
  "Prompt": "Photorealistic live-action epic science-fiction film, one continuous eight-second shot. An adult female pilot with dark hair tied back, wearing a weathered ivory flight suit, strides onto a vast spaceport observation deck at blue hour. Begin close beside her face, capturing her quiet awe and loose hair moving in the wind. The camera smoothly arcs around her shoulder and pulls back to reveal a colossal starship rising from the launch pad beyond the railing. Brilliant amber engine plumes illuminate rolling white vapor, tiny service vehicles and the glass towers of a futuristic coastal city. She raises one hand to shield her eyes as the ship climbs, warm engine light sweeping naturally across her face. Physical human performance, realistic scale, textured skin and fabric, volumetric light, elegant anamorphic cinematography, deep blue shadows and gold highlights. No cartoon, no illustration, no text overlays, no logos.",
  "EnhancePrompt": false,
  "Duration": 8,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-seoul",
    "CosBucketPath": "/justin/aigc-video/"
  }
}

1.0 Pro 请求示例 ​

json
{
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-pro",
  "Prompt": "Start with the red bottle in the first image and smoothly transform it into the blue bottle in the last image, white studio background, locked camera.",
  "EnhancePrompt": false,
  "Duration": 4,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-singapore",
    "CosBucketPath": "/vega/"
  },
  "ImageUrl": "",
  "LastImageUrl": ""
}

1.0 Lite 请求示例 ​

json
{
  "ModelName": "wand-vega-video",
  "ModelVersion": "1.0-lite",
  "Prompt": "A red bottle standing on a white studio table, camera slowly moves forward, soft product lighting.",
  "EnhancePrompt": false,
  "Duration": 4,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "StoreCosParam": {
    "CosBucketName": "example-1250000000",
    "CosBucketRegion": "ap-singapore",
    "CosBucketPath": "/vega/"
  },
  "ImageUrl": ""
}

基于文本的生成 ​

上述 1.5 Pro 请求示例 不使用参考图片或视频,通过文本指定场景、人物动作、镜头运动与灯光。

响应与结果查询 ​

生成请求会返回 TaskId。将相同的值传入 DescribeAigcVideoTask。

json
{
  "Response": {
    "TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c",
    "RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
  }
}
json
{
  "TaskId": "2600012260-AigcVideo-ca6bb6b1d81d4294b838d8258781a46c"
}

状态为 Status=DONE 且 VideoUrls 中返回地址后,即可使用结果。

json
{
  "Response": {
    "Status": "DONE",
    "ErrCode": "",
    "Message": "ok",
    "Resolution": "1280x720",
    "VideoUrls": [
      "https://example-1250000000.cos.ap-singapore.myqcloud.com/vega/result.mp4"
    ],
    "RequestId": "7128d22f-f3d2-4add-b306-1c9647b75831"
  }
}

特殊配置 ​

护栏解除 ​

可分别配置输入与输出审核。

如需使用护栏解除参数,请先联系商务负责人确认使用权限。即使在支持该引擎的情况下,也只有显式传入相应参数时才会解除护栏。省略参数则不会解除。

参数解除值适用对象
ExtraParameters.EnablelnputComplianceCheckfalse输入审核解除
ExtraParameters.EnableOutputComplianceCheckfalse输出审核解除

将以下配置合并到已有的生成请求中。如需同时解除输入与输出审核,请一并传入两个字段。

json
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

首帧 / 尾帧 ​

同时指定 ImageUrl 与 LastImageUrl。在 Prompt 中描述两个场景之间的运动或转场。

图片 / 视频参考 ​

图片传入 ImageInfos,视频传入 VideoInfos。在 Prompt 中具体说明各参考中要使用的产品、背景、运动等要素。

结果保存 ​

在 StoreCosParam 中指定存储桶名称、地域与保存路径。私有存储桶的结果可通过 COS SDK 或签名 URL 下载。鉴权、请求执行与保存的通用规格请参考 API Reference。

音频输出 ​

通过 ExtraParameters.EnableAudio 配置音频生成。在 1.5-pro 中需要静音文件时,不要仅凭指定 false 就假定音频轨道已被移除。请确认结果文件的轨道,必要时通过后处理移除音频。

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