VS
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
VS 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频,以及图片、视频、音频的多模态参考生成,并可同时生成音频。使用前需联系 WAND 团队开通白名单。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | VS |
| ModelVersion | 2.5 / 2.0 / 2.0-fast / 2.0-mini |
| 默认值 | ModelVersion=2.0 / Resolution=1080P |
| 支持解除安全护栏 | 不支持 |
各版本支持的规格
| 版本 | 分辨率 | 比例 | 时长 |
|---|---|---|---|
2.5 | 480P / 720P / 1080P / 2K / 4K | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive | 4~30 秒 |
2.0 / 2.0-fast / 2.0-mini | 480P / 720P / 1080P / 2K / 4K | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive | 4~15 秒 |
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 VS |
ModelVersion | 选填 | String | 2.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 | 选填 | Object | Resolution / 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。