Wan 그룹의 API 키(콘솔에서는 ‘토큰’이라고 부릅니다)가 필요하고, 비디오 길이(초)에 따라 과금됩니다.
Wan 토큰 만들기
Wan 모델은
Wan 그룹에서만 호출할 수 있으므로 토큰도 이 그룹으로 만들어야 합니다. default나 SeeDance2 같은 다른 그룹의 토큰으로는 호출할 수 없고, 사용 가능한 채널이 없다는 오류가 납니다. Wan 전용 토큰을 따로 두면 모델별, 작업별로 로그와 청구 내역을 확인하기도 쉽습니다.
과금과 가격
Wan 비디오는 Alibaba Cloud Model Studio 목록 가격에 20%를 더해 초 단위로 과금합니다. 추가분은 세금, 환전과 국경 간 정산, 플랫폼 운영, 기술 지원 비용에 쓰입니다. 2026년 10월 14일부터 환산 방식은 다음과 같습니다.- 초당 USD 가격 = Alibaba Cloud 초당 위안화 목록 가격 × 0.1714 (
Wan그룹 배율) - 고정 환율 1:7에서 0.1714 × 7 ≈ 1.2이므로 목록 가격의 약 1.2배를 지불합니다
Wan 2.7의 텍스트 투 비디오, 이미지 투 비디오, 참조 투 비디오, 비디오 편집 모델(
wan2.7-t2v, wan2.7-i2v, wan2.7-r2v, wan2.7-videoedit)은 가격이 같습니다. Alibaba Cloud 가격은 Model Studio 가격(중국어)의 화북 2(베이징) 리전 기준입니다.
청구 초는 다음과 같이 계산합니다.
- 출력만 있는 작업(텍스트 투 비디오, 이미지 투 비디오, 참조 이미지만 쓰는 작업): 생성된 비디오 길이
- 입력 비디오가 있는 작업: Alibaba Cloud와 같은 규칙으로 입력 길이 + 출력 길이
wan2.7-videoedit: 원본 비디오 + 출력.duration을 2~10초로 지정하면 원본을 앞부분부터 잘라 잘린 부분만 계산- 참조 비디오를 쓰는
wan2.7-r2v: 참조 비디오 최대 5초 + 출력 reference_video를 쓰는 Wan 3.0(참조, 편집, 연장): 입력 비디오 전체 길이 + 출력
resolution미지정: Wan 2.7과 Wan 3.0 모두 기본값이 1080P이므로 1080P로 과금
wan2.7-i2v, 720P, 5초: 5 × $0.1028 ≈ $0.51wan3.0-video, 1080P, 10초: 10 × $0.2057 ≈ $2.06- 5초 클립을 720P로
wan2.7-videoedit: (5 + 5) × $0.1028 ≈ $1.03
task_id와 연결해 두고, 조건 없는 자동 재시도는 피하세요.
작업별 실제 청구 금액은 호출 로그에 있습니다. 실패한 작업에 청구가 남아 있다면 작업 ID와 함께 고객 지원에 문의하세요.
비용은 출력 길이와 해상도로 정해지므로, duration과 resolution을 명시하고 작업을 만들기 전에 위 표로 비용을 추정하세요. Wan 모델과 그룹은 AI 모델 API 가격표에서 확인할 수 있습니다.
Wan 작업 처리 흐름
1
작업 생성
JSON 본문과
X-DashScope-Async: enable 헤더로 POST /wan/api/v1/services/aigc/video-generation/video-synthesis를 호출합니다. 응답의 output.task_id를 저장하세요.2
작업 조회
5~10초마다
GET /v1/tasks/{task_id}를 호출합니다. 중첩된 업스트림 필드가 아니라 최상위 status 필드로 분기하세요.3
비디오 다운로드
status가 completed이면 최상위 result_url에서 MP4를 내려받습니다. 서명된 오브젝트 스토리지 URL이므로 LaoZhang Authorization 헤더를 함께 보내지 마세요.환경 설정
셸 예제는curl과 jq를 사용합니다. jq는 brew install jq 또는 sudo apt-get install jq로 설치합니다. 키와 base URL을 한 번 설정해 두세요.
create.json에 저장하며, 작업 조회와 비디오 다운로드 단계에서 이 파일을 읽습니다.
텍스트로 비디오 만들기
output.task_id에 작업 ID가 들어 있습니다.
output.task_id가 없으면 create.json의 오류 메시지를 읽고, 아래 문제 해결 표를 확인하세요.
이미지로 비디오 만들기
driving_audio는 선택 항목입니다. Alibaba Cloud는 이 오디오로 비디오를 구동해, 위 랩 예제처럼 립싱크나 박자에 맞춘 움직임을 만듭니다. first_frame 이미지와 함께 쓸 때만 동작하며, 다른 미디어처럼 공개 HTTPS URL이어야 합니다.
지원하는 오디오 형식, 길이, 파일 크기는 Alibaba Cloud Wan 2.7 이미지 투 비디오 API 레퍼런스를 참고하세요.
참조 이미지로 비디오 만들기
비디오 편집
Wan 3.0 비디오 생성
Wan 3.0은 작업 종류마다 모델 ID를 나누지 않습니다. 모델 하나가input.media[] 항목을 읽고 텍스트 투 비디오, 이미지 투 비디오, 참조 투 비디오, 비디오 편집 중 어떤 작업인지 판단합니다. 두 모델의 기능은 같습니다.
wan3.0-video: 표준 모델wan3.0-video-prime: 더 빠르고 초당 가격이 더 높은 모델
참조 투 비디오 프롬프트에서는 입력을 “image 1”, “video 1”, “audio 1”(图1, 视频1, 音频1)처럼 가리킬 수 있습니다. 번호는 같은 유형의 입력 안에서 매겨지는 순서입니다.
일부
parameters는 Wan 2.7과 다르게 동작합니다.
최소한의 텍스트 투 비디오 요청입니다.
reference_video로 보냅니다. 청구 초에는 입력 비디오 길이도 포함됩니다(위의 과금과 가격 절 참고).
create.json에서 TASK_ID를 읽고, 다음 절의 방법으로 조회하고 내려받으세요. 문서(file)나 웹 페이지(link) 같은 다른 입력은 Alibaba Cloud Wan3.0 비디오 생성 API 레퍼런스(중국어)를 참고하세요.
작업 조회와 비디오 다운로드
create.json에서 작업 ID를 읽어 작업 상태를 확인합니다.
status가 submitted나 in_progress가 아닐 때까지 5~10초마다 다시 요청하세요.
완료된 작업은 다음과 같습니다. 최상위 status와 result_url 필드를 기준으로 처리하세요.
Authorization 헤더 없이 내려받으세요. result_url은 서명된 오브젝트 스토리지 URL이라, 인증 헤더를 추가하면 403 오류가 날 수 있습니다.
Python 클라이언트
Python 표준 라이브러리만 쓰는 클라이언트입니다(Python 3.8 이상). 텍스트 투 비디오 작업을 만들고 최대 20분 동안 조회한 뒤 MP4를 저장합니다.엔드포인트와 요청 규칙
작업 상태
GET /v1/tasks/{task_id}가 반환하는 최상위 status 필드로 분기하세요.
생성 응답에는 DashScope 원래 상태인
output.task_status도 있으며, 새 작업이면 보통 PENDING입니다. 이 값은 작업이 접수되었는지 확인하는 데만 쓰고, 이후에는 GET /v1/tasks/{task_id}의 최상위 status로 분기하세요.
submitted나 in_progress일 때만 계속 조회하세요. 작업이 취소되었거나 24시간이 지난 뒤 조회한 경우처럼 그 밖의 값은 모두 최종 상태로 처리해야, 예상하지 못한 상태 때문에 클라이언트가 끝없이 조회하는 일을 막을 수 있습니다.
Wan의 진행률은 단계가 거칩니다. progress가 한동안 30%에 머물다가 100%로 뛸 수 있습니다.
모델과 입력 방식
Wan 2.6 모델(
wan2.6-t2v, wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash)은 2026년 10월 14일에 종료되었습니다. 아직 호출하고 있다면 대응하는 Wan 2.7 모델이나 Wan 3.0으로 바꾸세요.
모델 ID는 2026년 10월 14일 기준 LaoZhang API 공개 가격표를 따랐습니다. wan2.7-image-pro는 이미지 모델이라 이 비디오 엔드포인트에서는 동작하지 않습니다.
요청 본문
허용 값은 모델마다 다릅니다. 위 범위는 Alibaba Cloud 텍스트 투 비디오 API 레퍼런스를 따랐습니다. 다른 모델은 해당 모델의 Alibaba Cloud 레퍼런스(중국어)를 확인하세요.
미디어 입력
모든 미디어
url은 Alibaba Cloud가 직접 가져올 수 있는 공개 HTTPS 링크여야 합니다. 로그인이나 쿠키가 필요한 링크, 사설 네트워크 주소, 작업이 실행되기 전에 만료되는 링크는 작업 실패의 원인이 됩니다.
운영 환경 팁
- 작업 ID부터 저장하세요. 생성 호출이 반환되면 바로
output.task_id를 자체 작업 ID와 함께 저장해, 워커가 재시작되어도 중복 작업을 만들지 않고 조회를 이어 가게 하세요. - 생성 호출을 재시도하기 전에 확인하세요. 접수된 생성 요청은 각각 별도의 작업이 됩니다. 생성 요청이 타임아웃되면 다시 보내기 전에 자체 기록과 호출 로그를 확인하세요.
- 조회에 한도를 두세요. 5~10초마다 확인하고 20분이 지나면 멈추며,
submitted나in_progress가 아닌 상태는 모두 최종 상태로 처리하세요. - 바로 내려받으세요. Alibaba Cloud는 작업 ID와 비디오 URL을 24시간 보관합니다. MP4를 자체 저장소에 복사하고, 사용자에게는 서명 링크가 아닌 자체 URL을 제공하세요.
- 입력에 계속 접근할 수 있게 하세요. 미디어는 작업이 끝날 때까지 열리는 공개 HTTPS URL에 두세요.
- 비용을 관리하세요.
duration과resolution을 명시하고, 호출 로그에서 작업별 청구 금액을 확인하세요. - 앱마다 토큰을 따로 쓰세요. 애플리케이션이나 환경마다 전용
Wan토큰을 두면 로그와 청구 내역을 확인하기 쉽습니다.
문제 해결
자주 묻는 질문
5초 비디오는 얼마인가요?
2026년 10월 14일 기준 가격으로, 비디오만 출력하는 작업의 비용입니다.wan3.0-video: 720P 약 $0.51, 1080P 약 $1.03wan3.0-video-prime: 720P 약 $0.77, 1080P 약 $1.54- Wan 2.7: 720P 약 $0.51, 1080P 약 $0.86
resolution을 지정하지 않으면 1080P로 과금되고, 입력 비디오가 있는 작업은 입력 길이가 더해집니다. 자세한 내용은 위의 과금과 가격 절을 참고하세요.
X-DashScope-Async: enable을 꼭 보내야 하나요?
네, 모든 생성 요청에 보내야 합니다. Wan HTTP API는 비동기로만 동작하며, 이 헤더 없이 생성 POST를 보내면 current user api does not support synchronous calls 오류가 납니다.
GET /v1/tasks/{task_id} 조회와 result_url 다운로드에는 필요 없습니다.
resolution과 duration을 생략하면 어떻게 되나요?
1080P로 출력됩니다. Alibaba Cloud API 레퍼런스에 따르면 Wan 2.7 모델 4종(wan2.7-t2v, wan2.7-i2v, wan2.7-r2v, wan2.7-videoedit)과 Wan 3.0의 기본값은 모두 1080P입니다.
- 텍스트 투 비디오, 이미지 투 비디오, 참조 투 비디오는 기본 5초입니다.
- Wan 2.7 비디오 편집은 원본 비디오 길이를 유지합니다.
- Wan 2.7: 약 $0.86
wan3.0-video: 약 $1.03wan3.0-video-prime: 약 $1.54
720P를 명시합니다. 비용을 예측할 수 있도록 모든 요청에 resolution과 duration을 지정하고, 위의 과금과 가격 절로 가격을 추정하세요.
세로나 정사각형 비디오는 어떻게 만드나요?
텍스트 투 비디오와 참조 투 비디오는parameters.ratio로 지정하고, 다른 작업은 입력의 비율을 따릅니다.
- 텍스트 투 비디오, 참조 투 비디오: 아래 비율 중 하나
16:9(기본값)9:16(예: 720P에서는 720×1280 비디오)1:14:33:4
- 이미지 투 비디오:
ratio를 받지 않고 첫 프레임의 비율을 따름 - 비디오 편집:
ratio를 지정하지 않으면 원본 비디오의 비율 유지 - Wan 3.0: 기본값
adaptive(입력에 맞춰 비율 선택)이며21:9도 지원
비디오에 소리가 있나요? 내 오디오로 캐릭터가 말하게 할 수 있나요?
둘 다 가능합니다. Alibaba Cloud에 따르면 Wan 2.7은 기본적으로 소리가 있는 비디오를 출력하며, 화면에 맞는 배경 음악, 효과음, 목소리를 생성합니다. 내 오디오에 입 모양을 맞추려면 위의 이미지로 비디오 만들기 예제처럼wan2.7-i2v를 쓰고 input.media[]에 driving_audio 항목을 추가하세요. 오디오는 WAV 또는 MP3, 길이 2~30초여야 하며 duration보다 긴 부분은 잘립니다.
Wan 3.0도 기본적으로 소리를 출력합니다. 무음 비디오가 필요하면 "audio": false를 보내세요. 가격은 같습니다.
참조 투 비디오는 참조 비디오의 목소리를 재사용할 수 있고, 비디오 편집은 원본 비디오의 소리를 유지할 수 있습니다. 관련 파라미터는 Wan 2.7 참조 투 비디오 API 레퍼런스와 Wan 2.7 비디오 편집 API 레퍼런스(모두 중국어)를 참고하세요.
”AI 生成” 워터마크는 어떻게 없애나요?
parameters에 "watermark": false를 보내거나 watermark를 생략하세요. Alibaba Cloud는 기본적으로 워터마크를 넣지 않습니다. 이 페이지의 예제는 true를 보내므로 비디오 오른쪽 아래에 워터마크가 들어갑니다. 운영 환경에서 예제를 쓰기 전에 바꾸세요.
클라이언트 타임아웃이나 실패 후 작업을 다시 제출해도 되나요?
먼저 작업을 확인하세요. 클라이언트 타임아웃은 작업 실패를 뜻하지 않습니다. 같은task_id를 24시간까지 계속 조회하세요. 새 생성 요청은 두 번째 작업을 만들어 다시 과금됩니다. status가 failed나 다른 최종 값이 된 뒤에만 요청을 고쳐 새 작업을 만드세요.
실패한 작업은 과금되지 않으며, 작업별 실제 청구 금액은 호출 로그에 있습니다. 위의 과금과 가격 절과 작업 상태 절을 참고하세요.
호출 로그에 작업 하나가 두 번 청구된 이유는 무엇인가요?
작업을 만들 때 요청한 길이만큼 차감하고, 작업이 끝나면 정산합니다.- Alibaba Cloud가 같은 초 수를 보고하면 로그에는 한 줄만 남습니다.
- 초 수가 다르면 두 번째 줄(“Wan 任务完成,按实际时长调整”)에서 차액을 환불하거나 추가 청구합니다.
progress가 30%에서 멈추면 작업이 멈춘 건가요?
아닙니다. 업스트림 서비스가 진행률을 큰 단계로 보고하므로 30%에서 잠시 머무는 것은 정상입니다. 최상위 status가 in_progress인 동안 계속 조회하세요. 위의 작업 상태 절을 참고하세요.
관련 문서
- Seedance 2.0 / 2.5 비디오 생성 API: LaoZhang API의 또 다른 비디오 모델 계열
- Sora 2 API 종료: Wan 또는 Seedance로 이전
- AI 모델 API 가격표
- 모델 사용 가능 여부 확인 방법
- 호출 로그 확인 방법
- 데이터와 로그의 범위
- Alibaba Cloud(중국어): 텍스트 투 비디오 API 레퍼런스, Wan 2.7 이미지 투 비디오 API 레퍼런스, Model Studio 가격