MPS APILast Updated 2026-09-30

PixVerse

On this page

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

기본 정보

항목	값
ModelName	`PixVerse`
ModelVersion	`c1` / `v6` / `v5.6`
가드레일 해제 지원	미지원

버전별 지원 규격

버전	해상도	비율	길이
`c1`	`360P` / `540P` / `720P` / `1080P`	—	`1–15초`
`v6`	`360P` / `540P` / `720P` / `1080P`	—	`1–15초`
`v5.6`	`360P` / `540P` / `720P` / `1080P`	—	`5` / `8` / `10초`; `1080P`는 `10초` 제외

입력 조건

버전	조건
`c1`	참조 / 오디오: 이미지 최대 `7장`, 영상 참조, 오디오 동시 생성
`v6`	참조 / 오디오: 이미지 최대 `7장`, 오디오 동시 생성
`v5.6`	참조 / 오디오: c1/v6의 참조 / 오디오 기능과 구분

해상도 선택 폭이 넓고 참조 생성과 오디오 동시 생성을 지원하는 엔진입니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `PixVerse`
`ModelVersion`	선택	String	`c1` / `v6` / `v5.6`
`Prompt`	필수	String	생성 프롬프트. 텍스트 입력 모드는 최대 `2000`자로 작성
`NegativePrompt`	선택	String	결과에서 제외할 요소. 지원 모델에서 적용
`EnhancePrompt`	선택	Boolean	프롬프트 자동 보정. 기본값 `false`
`ImageUrl`	선택	String	첫 프레임 이미지 URL. 외부 접근 가능해야 하고 `10MB` 이하
`LastImageUrl`	선택	String	끝 프레임 이미지 URL. `ImageUrl`과 함께 사용
`ImageInfos.N`	선택	Array	참조 이미지 배열. `Category` / `Url` / `ReferenceType` 등
`Duration`	선택	Integer	생성 길이(초). 모델별 허용값만 반영
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio` / `EnableAudio`
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조
`ImageInfos.N`	선택	Array	참조 이미지. `Text`로 이미지 이름을 주면 `Prompt`에서 `@이름`으로 지목

요청 예시

image-to-video + 오디오 동시 생성

LANGUAGE
{
  "ModelName": "PixVerse",
  "ModelVersion": "v6",
  "Prompt": "a sports car speeding on a coastal highway",
  "ImageUrl": "https://<cdn>/first.png",
  "Duration": 8,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

응답 예시

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

특수 설정

버전별 지원 능력

기능	`c1`	`v6`	`v5.6`
text-to-video	지원	지원	지원
image-to-video	지원	지원	지원
참조 생성	지원	지원	—
참조 영상	지원	—	—
최대 참조 이미지	`7장`	`7장`	—
해상도	`360P` / `540P` / `720P` / `1080P`	`360P` / `540P` / `720P` / `1080P`	`360P` / `540P` / `720P` / `1080P`
오디오 동시 생성	지원	지원	—
최대 길이	`1~15초` (`1080P` 최대 `15초`)	`1~15초`	`5` / `8` / `10초` (`1080P`는 `5초` 또는 `8초`)

추가 옵션

입력 이미지 규격

입력 이미지는 최대 10MB의 JPEG/JPG/PNG, 끝 프레임 이미지는 최대 5MB로 준비합니다.