Wan 3.0 API 가이드: 모델, 입력, 첫 동영상 준비
Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro, Wan 3.0 Prime Pro의 API 입력과 동영상 출력 사양을 비교하고 첫 테스트를 준비하는 방법을 안내합니다.
Wan 3.0 API를 연동할 때 가장 먼저 정할 것은 모델이 어떤 자료로 작업할지입니다. 글로 쓴 장면, 시작 이미지, 참조 자료 모음 중에서 선택할 수 있습니다. Alibaba Cloud는 Wan 3.0을 한 번에 최대 30초를 생성하고 텍스트, 이미지, 오디오, 동영상, 문서를 입력받는 동영상 모델로 설명합니다. 1
이 가이드에서는 각 선택지와 첫 테스트 준비 방법을 설명합니다. 여기서 다루는 내용은 상위 제공 모델의 기능이며, Wan API의 실제 서비스 엔드포인트와 키 발급 정보는 연동 문서에 공개할 예정입니다. 모델별 요금은 요금 페이지에 나와 있습니다. 아래 모델에는 각각 별도의 사양 페이지가 있습니다.
모델 이름 이해하기
Wan 3.0은 모델 제품군의 이름입니다. Comfy의 공식 연동에는 선택 가능한 모델로 wan3.0-video-prime도 나와 있습니다. 따라서 Prime은 별도의 옵션이지만, 제공업체의 모델 이름만으로 요청 스키마, 다른 서비스에서의 이용 가능 여부, 애플리케이션이 경험할 처리 시간을 알 수는 없습니다. 2
| 이름 | 연동 전 확인 사항 |
|---|---|
| Wan 3.0 | 텍스트, 이미지, 참조 자료 기반 작업 방식 및 480p, 720p, 1080p 출력 |
| Wan 3.0 Prime | 자체 요금이 있는 별도 Prime 모델, 최대 1080p 출력 |
| Wan 3.0 Pro | 1080p, 2K, 4K 출력을 지원하는 문서상 Pro 옵션 |
| Wan 3.0 Prime Pro | 1080p, 2K, 4K 설정을 제공하는 별도 Prime Pro 옵션 |
Prime과 Pro는 서로 다른 버전입니다. 선택 전에 해상도 옵션과 정확한 모델 식별자를 비교하세요. Wan 3.0과 Prime은 최대 1080p 출력을 지원하며, Pro와 Prime Pro는 2K와 4K 옵션을 추가로 제공합니다.
유의미하게 비교하려면 같은 프롬프트와 참조 자료를 동일한 길이와 해상도로 보내세요. 완료 시간, 비용, 결과가 제작 지시에 맞는지를 기록하세요. 모델 이름이 이러한 테스트를 대신할 수는 없습니다.
자료에 맞는 입력 선택하기
Comfy 문서는 Wan 3.0의 세 가지 작업 방식으로 텍스트 기반 동영상 생성, 이미지 기반 동영상 생성, 참조 자료 기반 동영상 생성을 설명합니다. 이미지 방식은 첫 프레임과 선택 사항인 마지막 프레임을 받습니다. 참조 방식은 이미지, 동영상, 오디오를 사용하며 @Image1, @Video1, @Audio1 같은 태그로 각 입력의 역할을 설명합니다. 이 이름과 태그는 해당 연동에 속하므로 실제로는 API 제공업체가 문서에 명시한 필드를 사용하세요. 2
| 시작 자료 | 실용적인 첫 테스트 |
|---|---|
| 글로 쓴 장면 | 피사체 하나, 동작 하나, 카메라 움직임 하나를 설명합니다 |
| 제품 사진 | 유지해야 할 세부 사항을 지정하면서 움직임을 설명합니다 |
| 여러 참조 자료 | 정체성, 제품 외형, 움직임, 소리 등 각 자료의 역할을 지정합니다 |
| 발표 자료 또는 문서 | 짧은 부분 하나, 명확한 대상 시청자와 메시지로 시작합니다 |
Alibaba의 문서 입력은 파일 또는 링크 하나를 지원하며 파일 크기는 최대 100 MB입니다. 50페이지 제한은 PDF, DOCX, DOC, PPTX, PPT, KEY, PAGES 파일에 적용됩니다. 게이트웨이에서 더 적은 입력 모드를 제공할 수도 있으므로 업로드 과정을 구현하기 전에 문서 지원 여부를 확인하세요. 1
평가하기 쉬운 첫 테스트 만들기
짧은 동영상과 명확한 출력 설정으로 시작하세요. 예를 들어 느린 카메라 움직임과 대사 없는 5초 제품 장면을 테스트할 수 있습니다. 다음은 API 페이로드가 아닌 테스트용 제작 지시 예시입니다.
부드러운 아침 햇살이 드는 창가에 도자기 커피잔이 놓여 있습니다. 김이 피어오르는 동안 카메라가 잔 쪽으로 천천히 이동합니다. 잔의 모양과 색상을 일관되게 유지합니다. 대사 없이 조용한 실내 환경음을 사용합니다.
제공업체에서 설정을 제공하는 경우 길이, 해상도, 화면 비율, 오디오를 의도에 맞게 지정하세요. Comfy의 현재 Wan 작업 방식은 기본으로 오디오를 포함하며 480p, 720p, 1080p 출력을 제공합니다. 이러한 문서상 설정은 유용한 시작점이지만 모든 Wan 엔드포인트가 동일한 제어 항목을 제공한다는 보장은 아닙니다. 2
피사체의 일관성, 요청한 움직임, 오디오, 활용 가능한 구도처럼 애플리케이션에 실제로 필요한 요소를 기준으로 결과를 검토하세요. Alibaba는 오디오 질감과 정확한 화면 속 글자를 계속 개선 중인 영역으로 밝히고 있으므로, 실제 서비스에 결과를 사용하기 전에 생성된 음성과 글자를 확인하세요. 1
작업 흐름 구현 전 API 규약 확인하기
운영 애플리케이션에 연결하기 전에 제공업체 문서에서 정확한 모델 ID, 인증 방식, 허용 미디어 형식, 작업 제출 및 결과 조회 방식, 오류 동작, 과금 규칙을 확인하세요. 이러한 기술적 세부 사항은 제작용 프롬프트와 구분하여 관리하세요.
Wan API에서는 모델 개요부터 살펴보세요. 공개된 엔드포인트에 인증된 요청을 성공적으로 보내는 것이 첫 연동 목표여야 합니다. 마케팅 페이지만으로는 API 사양을 확인할 수 없습니다.
출처
- Alibaba Cloud, Wan3.0: 30-Second AI Video Generation from Any Input. 2026년 8월 13일 게시, 2026년 10월 13일 확인.
- Comfy, Wan 3.0 Video Generation in ComfyUI. 2026년 10월 13일 확인. 여기에 인용한 설정은 Comfy의 연동 방식을 설명합니다.
Wan API 소식
API 이용 시작 및 모델 업데이트
이메일을 등록하시면 Wan API 이용 시작 알림과 Wan 모델 업데이트 소식을 보내드립니다.