跳到内容

VS ​

更新时间

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

VS 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频,以及图片、视频、音频的多模态参考生成,并可同时生成音频。使用前需联系 WAND 团队开通白名单。

基本信息 ​

项目值
ModelNameVS
ModelVersion2.5 / 2.0 / 2.0-fast / 2.0-mini
默认值ModelVersion=2.0 / Resolution=1080P
支持解除安全护栏不支持

各版本支持的规格 ​

版本分辨率比例时长
2.5480P / 720P / 1080P / 2K / 4K21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive4~30 秒
2.0 / 2.0-fast / 2.0-mini480P / 720P / 1080P / 2K / 4K21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive4~15 秒

请求参数 ​

参数必填类型说明
ModelName必填String固定值 VS
ModelVersion选填String2.5 / 2.0 / 2.0-fast / 2.0-mini
Prompt必填String生成提示词。最多 2000 字符
ImageUrl选填String首帧图片 URL。需可外部访问且不超过 10MB
LastImageUrl选填String尾帧图片 URL。与 ImageUrl 配合使用
ImageInfos.N选填Array参考图片数组。如 Category / Url / ReferenceType 等
Duration选填Integer生成时长(秒)。2.0 系列为 4~15,2.5 为 4~30
ExtraParameters选填ObjectResolution / AspectRatio / EnableAudio
AdditionalParameters选填String承载模型专属选项的 JSON 字符串。seed 的传递格式请参考附加配置。如 bitrate_mode 等

请求示例 ​

json
{
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "AdditionalParameters": "{\"seed\":12312}"
}

响应示例 ​

json
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "Resolution": "1920x1080",
    "VideoUrls": [
      "https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
    ],
    "RequestId": "<request-id>"
  }
}

Seed ​

seed 在顶层 AdditionalParameters 的 JSON 字符串中指定。它与 ExtraParameters 对象是相互独立的字段。若同一请求中存在其他模型选项,则合并为一个 JSON 对象后序列化。

json
{
  "AdditionalParameters": "{\"seed\":12312}"
}
python
import json

additional_parameters = json.dumps({"seed": 12312})

特殊配置 ​

高码率输出 ​

在 AdditionalParameters 中将 bitrate_mode 指定为 high,即可以高码率输出。与 VOD 路径在 ExtInfo 内再嵌套一层 AdditionalParameters 不同,MPS 路径只需在顶层 AdditionalParameters 中指定一次 JSON 字符串。

json
{
  "ModelName": "VS",
  "ModelVersion": "2.5",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "Duration": 5,
  "AdditionalParameters": "{\"bitrate_mode\":\"high\",\"seed\":12312}",
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

附加选项 ​

输出规格

输出尺寸为 480P 854x480、1080P 1920x1080、2K 2560x1440、4K 3840x2160。1080P 使用 HEVC 编码,其余使用 H.264 编码。

生成时长

2.5 最多指定为 30 秒(721 帧),2.0 系列最多为 15 秒(361 帧)。

指定首帧时的比例

首帧生成或首/尾帧生成的输出比例沿用首帧图片。在此模式下省略 AspectRatio。

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