MPS APILast Updated 2026-09-30

Wan

On this page

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

기본 정보

항목	값
ModelName	`Wan`
ModelVersion	`3.0` / `3.0-prime` / `2.2`
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	길이
`3.0` / `3.0-prime`	기본 출력: `480P` / `720P` / `1080P` 업스케일 출력: `2K` / `4K`	`16:9` / `9:16` / `4:3` / `3:4` / `1:1` / `adaptive`	`2–30초`; 참조 영상이 있으면 입력+출력 `30초` 이하

입력 조건

항목	조건
출력 프레임률	`30fps`
참조 이미지	최대 `10장`
참조 영상	최대 `5개`, 합계 `15초`
참조 오디오	최대 `5개`, 합계 `15초`

3.0은 표준 버전, 3.0-prime은 같은 품질에서 처리 속도를 높인 버전, 2.2는 이전 세대 버전입니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Wan`
`ModelVersion`	선택	String	`3.0` / `3.0-prime` / `2.2`
`Prompt`	필수	String	생성 프롬프트
`ImageUrl`	선택	String	첫 프레임 이미지 URL
`LastImageUrl`	선택	String	끝 프레임 이미지 URL. `ImageUrl`과 함께 사용
`Duration`	선택	Integer	생성 길이(초). 기본값 `5`
`ExtraParameters`	선택	Object	`Resolution` / `AspectRatio`
`AdditionalParameters`	선택	String	모델 전용 옵션을 담은 JSON 문자열. `seed` 전달 형식은 추가 설정 참조
`ExtraParameters.` `EnablelnputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
`ExtraParameters.` `EnableOutputComplianceCheck`	선택	Boolean	`false`를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

LANGUAGE
{
  "ModelName": "Wan",
  "ModelVersion": "3.0",
  "Prompt": "a woman walks through a sunlit marketplace, camera follows behind her",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "1080P",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

응답 예시

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

특수 설정

가드레일 해제

입력과 출력 심사를 각각 설정할 수 있습니다.

가드레일 해제 파라미터를 사용하려면 먼저 영업담당자에게 연락해 사용 권한을 확인해야 합니다. 지원 엔진에서도 해당 파라미터를 명시적으로 전달하는 경우에만 가드레일 해제가 적용됩니다. 파라미터를 생략하면 해제되지 않습니다.

파라미터	해제 값	적용 대상
`ExtraParameters.EnablelnputComplianceCheck`	`false`	입력 심사 해제
`ExtraParameters.EnableOutputComplianceCheck`	`false`	출력 심사 해제

다음 설정을 기존 생성 요청에 병합합니다. 입력과 출력 심사를 모두 해제하려면 두 필드를 함께 전달합니다.

LANGUAGE
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

출력 해상도

ExtraParameters의 Resolution과 AspectRatio로 지정합니다. 지정한 값에 따른 출력 해상도는 다음과 같습니다.

ModelVersion	Resolution	AspectRatio	출력 해상도
`3.0`	`1080P`	`16:9`	`1920x1080`
`3.0-prime`	`720P`	`16:9`	`1280x720`
`2.2`	`720P`	`16:9`	`1280x704`

첫 프레임 이미지를 넣으면 출력 비율은 입력 이미지를 따릅니다.

첫/끝 프레임 생성

ImageUrl과 LastImageUrl에 각각 이미지 URL을 지정합니다.

LANGUAGE
{
  "ModelName": "Wan",
  "ModelVersion": "3.0",
  "ImageUrl": "https://<cdn>/first.png",
  "LastImageUrl": "https://<cdn>/last.jpg",
  "Prompt": "she opens the window and looks into the distance",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "720P"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}