Wan

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: 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를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

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

응답 예시

{
  "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	출력 심사 해제

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

{
  "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을 지정합니다.

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