VOD APILast Updated 2026-09-05

Wan

On this page

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

기본 정보

항목	값
ModelName	`Wan`
ModelVersion	`3.0` / `3.0-prime`
프롬프트 길이	최대 `20,000`자
기본값	`ModelVersion=3.0` / `Duration=5` / `AspectRatio=adaptive`
가드레일 해제 지원	지원

버전별 지원 규격

버전	해상도	비율	길이
`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은 고속 버전입니다.

요청 파라미터

파라미터	필수	타입	설명
`ModelName`	필수	String	고정값 `Wan`
`ModelVersion`	선택	String	`3.0` / `3.0-prime`
`Prompt`	필수	String	생성 프롬프트. 최대 `20,000`자
`FileInfos.N`	선택	Array	참조 입력. `Usage`는 `FirstFrame` / `LastFrame` / `Reference`
`OutputConfig.Resolution`	선택	String	`480P` / `720P` / `1080P` / `2K` / `4K`
`OutputConfig.Duration`	선택	Integer	영상 길이(초). 기본값 `5`
`OutputConfig.AspectRatio`	선택	String	`adaptive` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16`
`OutputConfig.` `InputComplianceCheck`	선택	String	`Disabled`를 명시적으로 전달하면 입력 심사 해제. 사용 전 영업담당자 문의
`OutputConfig.` `OutputComplianceCheck`	선택	String	`Disabled`를 명시적으로 전달하면 출력 심사 해제. 사용 전 영업담당자 문의

요청 예시

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Wan",
  "ModelVersion": "3.0",
  "Prompt": "a woman walks through a sunlit marketplace, camera follows behind her",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 10,
    "AspectRatio": "9:16",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

응답 예시

LANGUAGE
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

특수 설정

가드레일 해제

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

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

파라미터	해제 값	적용 대상
`OutputConfig.InputComplianceCheck`	`Disabled`	입력 심사 해제
`OutputConfig.OutputComplianceCheck`	`Disabled`	출력 심사 해제

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

LANGUAGE
{
  "OutputConfig": {
    "InputComplianceCheck": "Disabled",
    "OutputComplianceCheck": "Disabled"
  }
}

첫/끝 프레임 생성

FileInfos.N.Usage로 FirstFrame / LastFrame을 지정합니다.

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Wan",
  "ModelVersion": "3.0",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/first.png",
      "Usage": "FirstFrame"
    },
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/last.jpg",
      "Usage": "LastFrame"
    }
  ],
  "Prompt": "she opens the window, looks into the distance, then runs out of the castle and rides away",
  "OutputConfig": {
    "Duration": 10,
    "Resolution": "2K",
    "AspectRatio": "9:16",
    "StorageMode": "Permanent"
  },
  "SessionContext": "job-001"
}

입력	제약
첫/끝 프레임 포맷	JPEG / JPG / 불투명 PNG / BMP / WEBP
첫/끝 프레임 해상도	한 변 `[240, 8000]` 픽셀
첫/끝 프레임 비율	`8:1` 이하
첫/끝 프레임 크기	`20MB` 이하

첫/끝 프레임 입력

Wan은 첫 프레임 1장 또는 첫/끝 프레임 조합으로 생성합니다.

멀티모달 참조 생성

Usage=Reference로 이미지, 영상, 오디오를 참조로 지정합니다. Category로 종류를 구분합니다.

입력	제약
이미지	최대 `10`장. JPEG / JPG / 불투명 PNG / BMP / WEBP. 한 변 `[240, 8000]` 픽셀, 비율 `8:1` 이하, `20MB` 이하
영상	최대 `5`개. mp4 / mov. 개별 `1~15초`, 전체 `15초` 이하. 한 변 `[240, 4096]` 픽셀, 비율 `8:1` 이하, 개별 `100MB` 이하
오디오	최대 `5`개. wav / mp3. 개별 `1~15초`, 전체 `15초` 이하. 개별 `15MB` 이하

LANGUAGE
{
  "SubAppId": 123456789,
  "ModelName": "Wan",
  "ModelVersion": "3.0",
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Url": "https://<cos>/ref1.png",
      "Usage": "Reference"
    },
    {
      "Type": "Url",
      "Category": "Video",
      "Url": "https://<cos>/ref2.mp4",
      "Usage": "Reference"
    }
  ],
  "Prompt": "the character from the reference image walks through the scene in the reference video",
  "OutputConfig": {
    "Duration": 10,
    "Resolution": "1080P",
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

첫/끝 프레임과 참조 모드

첫/끝 프레임 모드와 멀티모달 참조 모드 중 하나를 선택합니다. 참조 모드에서는 이미지 / 영상 / 오디오를 조합할 수 있습니다.

영상 길이

조건	허용 범위
영상 입력 —	`[2, 30]` 범위의 정수
영상 입력 있음	입력 영상 총 길이 + 출력 영상 길이가 `30초` 이하
`Duration=-1`	스마트 길이. 프롬프트와 입력 미디어를 보고 모델이 길이를 자동 결정

LANGUAGE
{
  "OutputConfig": {
    "Duration": -1,
    "Resolution": "1080P",
    "StorageMode": "Temporary"
  }
}