VS

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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 등

요청 예시

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

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

import json

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

특수 설정

고비트레이트 출력

AdditionalParameters에 bitrate_mode를 high로 지정하면 고비트레이트로 출력합니다. VOD 경로가 ExtInfo 안에 AdditionalParameters를 한 번 더 중첩하는 것과 달리, MPS 경로는 최상위 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/"
  }
}

추가 옵션

출력 규격

출력 크기는 480P 854x480, 1080P 1920x1080, 2K 2560x1440, 4K 3840x2160입니다. 1080P는 HEVC로, 나머지는 H.264로 인코딩됩니다.

생성 길이

2.5는 최대 30초(721프레임), 2.0 계열은 최대 15초(361프레임)로 지정합니다.

첫 프레임 지정 시 비율

첫 프레임 또는 첫/끝 프레임 생성의 출력 비율은 첫 프레임 이미지를 따릅니다. 이 모드에서는 AspectRatio를 생략합니다.