Skip to content

VS โ€‹

Updated

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 โ€‹

ItemValue
ModelNameVS
ModelVersion2.5 / 2.0 / 2.0-fast / 2.0-mini
Default valueModelVersion=2.0 / Resolution=1080P
Guardrail release supportNot supported

Supported Specifications by Version โ€‹

VersionResolutionAspect RatioLength
2.5480P / 720P / 1080P / 2K / 4K21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive4~30 seconds
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 seconds

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value VS
ModelVersionOptionalString2.5 / 2.0 / 2.0-fast / 2.0-mini
PromptRequiredStringGeneration prompt. Up to 2000 characters
ImageUrlOptionalStringFirst frame image URL. Must be externally accessible and 10MB or less
LastImageUrlOptionalStringLast frame image URL. Used together with ImageUrl
ImageInfos.NOptionalArrayReference image array. Category / Url / ReferenceType, etc.
DurationOptionalIntegerGeneration length (seconds). The 2.0 series is 4~15, 2.5 is 4~30
ExtraParametersOptionalObjectResolution / AspectRatio / EnableAudio
AdditionalParametersOptionalStringA JSON string containing model-specific options. For the seed delivery format, see Additional Settings. bitrate_mode, etc.

Request Example โ€‹

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

Response Example โ€‹

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 โ€‹

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.

json
{
  "AdditionalParameters": "{\"seed\":12312}"
}
python
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.

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/"
  }
}

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.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages