Skip to main content

개요

Wan3.0은 Tongyi Wanxiang의 올인원 동영상 모델입니다. 4개의 모델 ID(t2v / i2v / r2v / videoedit) 사이를 전환해야 했던 Wan2.7과 달리, Wan3.0은 단일 모델 ID로 모든 모드를 처리합니다 — 전송하는 미디어에 따라 동작 방식이 결정됩니다. 텍스트 투 비디오, 이미지 투 비디오, 레퍼런스 투 비디오 및 동영상 편집이 모두 하나의 요청 본문을 공유합니다. 기능은 동일하며 속도와 가격이 다른 두 가지 변형이 제공됩니다:
두 변형 모두 완전히 동일한 파라미터, 엔드포인트 및 미디어 규칙을 공유하며, 속도와 단가만 다릅니다. 먼저 wan3.0-video을(를) 기반으로 개발한 후, 지연 시간에 민감한 프로덕션 트래픽을 wan3.0-video-prime(으)로 전환하십시오.

Wan2.7 대비 변경 사항

Wan2.7은 계속해서 완전하게 이용하실 수 있습니다 — Wan2.7 동영상 생성을 참고하십시오.

주요 기능

4가지 모드, 하나의 모델

텍스트 투 비디오, 이미지 투 비디오(첫 프레임/마지막 프레임), 레퍼런스 투 비디오(이미지, 동영상, 오디오) 및 동영상 편집은 하나의 모델 ID와 하나의 엔드포인트를 공유하며, type을(를) input.media[]에서 지정하여 구분됩니다.

최대 30초

요청당 최대 30초(입력 레퍼런스 동영상 + 출력 합산)를 지원하며, 이는 Wan2.7의 15초 대비 2배로 전체 보이스오버 구간이나 숏폼 드라마의 한 샷을 담아내기에 충분합니다.

네이티브 오디오

출력 결과물에 기본적으로 soun 트랙이 포함되어 제공되므로 별도의 드라이빙 오디오가 필요하지 않습니다. 특정한 음색을 원하는 경우에는 reference_audio을(를) 사용하십시오.

3가지 해상도 티어

새로운 480P 티어는 1080P의 4분의 1 비용으로 제공되므로, 초안을 저렴하게 생성한 후 최종 렌더링을 위해 업스케일할 수 있습니다.

그룹 설정

Wan3.0은 Wan&HappyHorse 그룹을 Wan2.7 및 HappyHorse와 공유하며, 키 하나로 모두 호출할 수 있습니다. 동영상은 초당 과금되므로 성공적으로 라우팅하려면 키가 다음 두 가지 조건을 충족해야 합니다:
  1. 과금 모드: “종량제 우선” 또는 “종량제” 선택 — 초당 과금 동영상은 호출당 과금 키로 라우팅할 수 없습니다
  2. 그룹: Wan&HappyHorse 포함
Token 생성 화면: 과금 모드를 종량제 우선으로 설정, 그룹 드롭다운을 Wan&HappyHorse (0.14x)로 설정

Create a key: set billing mode to pay-as-you-go priority and select the Wan&HappyHorse group (0.14x) to call every Wan3.0 / Wan2.7 / HappyHorse video model (the screenshot shows the old group name Wan)

가격 정책

기본적으로 알리바바 공식 가격의 98%가 적용되며, 최대 충전 보너스 적용 시 최저 81.7%까지 낮아집니다. wan3.0-video 기준 480P는 초당 $0.0245(≈ 초당 ¥0.17), 720P는 초당 $0.049(≈ 초당 ¥0.34)에 이용할 수 있습니다.

요율 산정 방식: 기본 0.98배, 보너스 적용 시 최저 0.817배

콘솔에는 Wan&HappyHorse 그룹이 0.14배 요율 배수로 표시되며 통화는 CNY 기준입니다. APIYI는 1:7 고정 환율의 USD로 정산합니다:
따라서 APIYI의 초당 가격(USD) = 알리바바 공식 초당 CNY 가격 × 0.14이며, 이는 공식 요율의 98%에 해당합니다.

표 1: APIYI 상세 가격 정책 (초당 과금)

“10% / 20% 보너스 적용 시”는 충전 보너스로 적립 잔액이 늘어난 후의 실질 단가이며, 매 호출 시 차감되는 금액은 여전히 기본 가격입니다.

표 2: 알리바바 공식 가격 대비 구간별 비교

wan3.0-video에는 현재 공식적으로 기간 한정 30% 할인이 적용 중이며(모든 사용자에게 기본 적용), APIYI 가격 또한 이 할인율을 따릅니다. wan3.0-video-prime에는 할인이 적용되지 않습니다. 프로모션이 종료되면 APIYI 가격도 조정됩니다.

표 3: 주요 생성 시간별 총비용

충전 보너스 중복 혜택

충전 보너스를 이용하면 적립 잔액이 최대 약 1.2배로 증가하여 실질 요율이 더욱 낮아집니다:
1:7은 프로모션 요율이 아닌 고정 정산 환율이며, 모든 USD 충전에 적용됩니다.
가격은 제공업체의 공식 요율에 맞춰 책정되며 변동 시 함께 조정될 수 있습니다. 위 표는 참고용이며, 상단 내비게이션의 모델 가격 정책 탭의 내용이 우선합니다: 모델 가격 정책.

⚠️ 과금 규칙 (다른 동영상 모델과 상이)

과금 시간(초) = 입력 참조 동영상 길이 + 출력 동영상 길이. Alibaba 공식 안내에 따름: “입력 동영상과 출력 동영상 모두 길이에 따라 과금되며, 단가는 출력 해상도에 의해 결정됩니다.”
비용을 절감하려면 참조 동영상을 트리밍하십시오. duration을 줄여도 입력 시간(초)은 줄어들지 않습니다. 예: 10초 참조 동영상에 2초 출력을 생성하면 12초가 과금되지만, 참조 동영상을 3초로 트리밍하면 5초만 과금됩니다.

사전 승인 및 정산

  • 참조 동영상이 없는 경우: 요청된 duration 요금이 선청구되며 이것이 최종 금액이 됩니다. 별도의 정산 내역은 발생하지 않습니다.
  • 참조 동영상이 있는 경우: 제출 시점에 게이트웨이는 입력 동영상의 길이를 알 수 없으므로 30초 상한선을 기준으로 사전 승인한 후, 실제 과금된 시간(초)에 따라 재계산하여 차액을 환불합니다(청구서에 별도의 마이너스 내역으로 표시).
상한선 기준 동결로 인해 일시적으로 더 큰 금액이 묶이게 됩니다: 480P는 $0.147, 720P는 $0.294, 1080P는 $0.588(wan3.0-video, 30초). 충분한 잔액을 유지해 주시기 바랍니다. 환불은 작업 완료 후 수초 이내에 이루어집니다.

⚠️ 엔드포인트 선택 (가장 중요)

APIYI는 두 가지 경로를 제공하지만, DashScope 패스스루 엔드포인트만 Wan3.0을 완벽하게 지원합니다:
Wan 동영상 작업을 /v1/videos(으)로 제출하는 문서나 예제는 무시하십시오. 해당 경로는 media 필드를 누락하고, 해상도 및 재생 시간 매개변수를 무시하며 초과 과금됩니다. 모든 Wan3.0 요청은 /wan/api/v1/...video-synthesis(으)로 전송하십시오.

비동기 워크플로

1

작업 생성

X-DashScope-Async: enable 헤더와 함께 POST /wan/api/v1/services/aigc/video-generation/video-synthesis를 호출합니다. 즉시 task_id을 반환합니다.
2

상태 폴링

status가 completed가 될 때까지 5~10초 간격으로(3초 미만 금지) GET /v1/tasks/{task_id}(Authorization 포함)를 호출합니다.
3

동영상 다운로드

응답에서 result_url를 직접 GET합니다 — Authorization 헤더 없이 요청하십시오(서명된 OSS 링크이므로 인증 정보를 전송하면 403이 반환됩니다). 24시간 동안 유효합니다.

작업 상태

최종 상태 값은 DashScope 네이티브의 SUCCEEDED / FAILED가 아닌 **completed / failed**입니다. 네이티브 enum을 기준으로 작성된 코드는 무한히 폴링하게 됩니다.
유효하지 않은 매개변수 또한 동기식 400이 아니라 먼저 HTTP 200을 반환한 후 비동기식으로 실패합니다 — 접근할 수 없는 미디어 URL이나 입력+출력 총합이 30초를 초과하는 문제 등은 최종 상태까지 폴링해야만 나타납니다. 제출 시 반환되는 상태 코드만 신뢰해서는 안 됩니다.

전체 Python 클라이언트

매개변수 참조

요청 본문은 중첩된 DashScope 구조를 사용합니다: { model, input: { prompt, media[] }, parameters: {...} }.

input 필드

media[] 타입 및 선택되는 모드

first_frame / last_frame은(는) reference_* / file / link와(과) 함께 혼용할 수 없습니다 — 두 에셋 제품군은 상호 배타적이며, 혼용 시 업스트림에서 거부됩니다.
모든 미디어 객체에는 최소한 type 및 url이 필요합니다. url은 공개적으로 접근 가능한 https 링크여야 합니다(로컬 파일을 먼저 OSS / CDN에 업로드하고, 작업이 완료될 때까지 접근 가능한 상태를 유지하십시오).

parameters 필드

duration은(는) 반드시 정수여야 하며(5, "5" 아님), resolution은(는) 대문자(720P)로 지정하는 것이 더 안정적입니다.

선택 가이드: Wan3.0 / Wan2.7 / HappyHorse

모범 사례

480P 비용은 1080P의 4분의 1 수준입니다. 적은 비용으로 prompt와 카메라 움직임을 먼저 확정하십시오. 5초 분량의 1080P 렌더링 1회 비용으로 4개의 초안을 제작할 수 있습니다.
입력 동영상의 재생 시간(초)에 따라 과금됩니다. 클립에서 3초만 필요하다면 30초 분량의 원본을 업로드하지 마십시오. 이는 Wan3.0에서 가장 빠지기 쉬운 비용 함정입니다.
동영상 모델은 “누가 무엇을 하고, 카메라가 어떻게 움직이는지”에 반응합니다. “창가에서 기지개를 켜는 치즈 고양이, 서서히 돌리 인”이 “귀여운 치즈 고양이, 햇빛, 고화질”보다 훨씬 더 나은 결과를 생성합니다.
5초 클립 기준 실측 소요 시간: 480P에서 약 100초, 720P에서 약 120초, 1080P에서 약 170초입니다. 5~10초 간격으로 폴링해도 충분합니다.
실패한 작업은 전액 환불되지만, 다시 제출하면 다시 과금됩니다. 검열 실패 시에는 prompt를 수정하고, 에셋 관련 오류인 경우 먼저 URL 접근 가능 여부를 확인하십시오.

자주 묻는 질문

과금 시간(초) = 입력 참조 동영상 길이 + 출력 길이입니다. 10초 참조 동영상과 2초 출력의 경우 12초가 과금됩니다. 참조 이미지, 오디오 및 파일은 무료입니다.
참조 동영상이 포함된 작업은 30초 한도로 사전 승인된 후, 실제 과금된 시간(초)을 기준으로 정산하여 차액을 환불합니다. 청구서에서 마이너스 조정 항목을 확인할 수 있습니다.
이는 업스트림의 대략적인 보고일 뿐, 작업이 중단된 것이 아닙니다. 1080P 또는 긴 클립은 3~5분이 걸릴 수 있습니다. 계속 폴링을 수행하십시오.
Authorization 헤더를 전송하지 마십시오. 서명된 OSS 링크입니다. 링크는 24시간 후 만료되므로 신속하게 재호스팅하십시오.
매개변수 및 에셋 오류는 동기식 400이 아닌 비동기식으로 실패 처리됩니다. 일반적인 원인: 접근할 수 없는 미디어 URL(만료된 서명 링크 포함), 입력 + 출력이 30초를 초과함, 콘텐츠 검열. 실패한 작업은 전액 환불됩니다.
키의 과금 모드가 종량제인지(호출당 과금 키는 동영상 모델을 라우팅할 수 없음), 해당 그룹에 Wan&HappyHorse이 포함되어 있는지 확인하십시오.

관련 문서

동영상 생성 API 레퍼런스

라이브 Playground 및 cURL / Python / Node 샘플

Wan2.7 동영상 생성

오디오 기반 립싱크를 지원하는 이전 4개 모델 세대

HappyHorse 동영상 생성

동일한 그룹의 다른 동영상 시리즈

모델 요금

사이트 전체의 공식 요금표
공식 참고 자료: help.aliyun.com/zh/model-studio/wan3-video-generation-guide, help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference