VS โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
VS is a video generation model that supports text-to-video, first-frame / first-and-last-frame video generation, and multimodal reference generation from images, video, and audio, and can generate audio at the same time. Contact the WAND team to be added to the allowlist before use.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | VS |
| ModelVersion | 2.5 / 2.0 / 2.0-fast / 2.0-mini |
| Default value | ModelVersion=2.0 / Resolution=1080P |
| Guardrail release support | Not supported |
Supported Specifications by Version โ
| Version | Resolution | Aspect Ratio | Length |
|---|---|---|---|
2.5 | 480P / 720P / 1080P / 2K / 4K | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive | 4~30 seconds |
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 seconds |
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value VS |
ModelVersion | Optional | String | 2.5 / 2.0 / 2.0-fast / 2.0-mini |
Prompt | Required | String | Generation prompt. Up to 2000 characters |
ImageUrl | Optional | String | First frame image URL. Must be externally accessible and 10MB or less |
LastImageUrl | Optional | String | Last frame image URL. Used together with ImageUrl |
ImageInfos.N | Optional | Array | Reference image array. Category / Url / ReferenceType, etc. |
Duration | Optional | Integer | Generation length (seconds). The 2.0 series is 4~15, 2.5 is 4~30 |
ExtraParameters | Optional | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | Optional | String | A JSON string containing model-specific options. For the seed delivery format, see Additional Settings. bitrate_mode, etc. |
Request Example โ
{
"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}"
}Response Example โ
{
"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 โ
Specify seed inside the JSON string of the top-level AdditionalParameters. It is a separate field from the ExtraParameters object. If the same request has other model options, merge them into a single JSON object and serialize it.
{
"AdditionalParameters": "{\"seed\":12312}"
}import json
additional_parameters = json.dumps({"seed": 12312})Special Settings โ
High Bitrate Output โ
Specifying bitrate_mode as high in AdditionalParameters outputs at a high bitrate. Unlike the VOD path, which nests AdditionalParameters one more level inside ExtInfo, the MPS path specifies the JSON string only once in the top-level AdditionalParameters.
{
"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/"
}
}Additional Options โ
Output Specifications
The output sizes are 480P 854x480, 1080P 1920x1080, 2K 2560x1440, and 4K 3840x2160. 1080P is encoded with HEVC, and the rest are encoded with H.264.
Generation Length
Specify 2.5 up to a maximum of 30 seconds (721 frames), and the 2.0 series up to a maximum of 15 seconds (361 frames).
Aspect Ratio When Specifying the First Frame
The output aspect ratio of first-frame or first/last-frame generation follows the first frame image. In this mode, omit AspectRatio.