MPS APILast Updated 2026-09-30

VS

On this page

Endpoint: POST https://mps.intl.tencentcloudapi.com
Action: CreateAigcVideoTask

기본 정보

항목	값
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` 등

요청 예시

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

응답 예시

LANGUAGE
{
  "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 객체로 합쳐 직렬화합니다.

LANGUAGE
{
  "AdditionalParameters": "{\"seed\":12312}"
}

LANGUAGE
import json

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

특수 설정

고비트레이트 출력

AdditionalParameters에 bitrate_mode를 high로 지정하면 고비트레이트로 출력합니다. VOD 경로가 ExtInfo 안에 AdditionalParameters를 한 번 더 중첩하는 것과 달리, MPS 경로는 최상위 AdditionalParameters에 JSON 문자열을 한 번만 지정합니다.

LANGUAGE
{
  "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를 생략합니다.