Wan3.0
Wan3.0 동영상 생성
- 알리바바 클라우드 완상 3.0 올인원 참조 동영상 모델 (통합 엔드포인트)
- 텍스트→동영상 / 첫 프레임 / 첫·마지막 프레임 / 멀티모달 참조 / 파일·웹 참조
- 해상도 480P / 720P / 1080P, 길이 2–30초
- 이미지, 동영상, 오디오, 문서, 공개 웹 페이지를 참조로 사용 가능
POST
인증
string
필수
생성 모드
모델 이름은wan3.0-video 로 고정. 요청 필드에 따라 모드가 결정됩니다:
요청 매개변수
기본
string
필수
고정값:
wan3.0-videostring
텍스트 설명. 미디어 필드와 적어도 하나는 필수.
- 최대 20,000자. 초과분은 오류 없이 자동 잘림
- 참조 모드에서는 「图N / 视频N / 音频N」으로 에셋을 지정. 번호는 각 미디어 유형 내 순서를 따름
string
기본값:"1080P"
출력 해상도 (대소문자 구분 없음)
480P720P1080P(기본값, 최고 요금)
string
기본값:"adaptive"
가로세로 비율.
aspect_ratio 도 허용됩니다.adaptive(기본값)16:9/4:3/1:1/3:4/9:16
integer
기본값:"5"
생성 길이(초), 2–30, 기본값
5참조 동영상 입력이 있을 때, 입력 동영상 총 길이 + 출력
duration 은 30초 이하여야 합니다.boolean
기본값:"true"
출력에 오디오 트랙 포함 여부. 기본값
true. 오디오 유무와 관계없이 요금 동일.integer
난수 시드, 범위
[0, 2147483647]boolean
기본값:"false"
워터마크 추가 여부. 기본값
falsestring
순수
image_urls 분류 방식:frame— 첫/마지막 프레임 계열reference— 참조 계열
미디어 입력
string[]
이미지 URL 배열. 역할 할당은 상호 배제 규칙을 따릅니다.공개 URL 또는 Base64 (
data:image/png;base64,...).object[]
역할이 명시된 이미지 배열. 각 항목:
url: 이미지 주소role:first_frame/last_frame/reference_image(일반 별칭 허용)
string[]
참조 동영상, 최대 5개. 각 1–15초, 총합 ≤ 15초
string[]
참조 오디오, 최대 5개. 각 1–15초, 총합 ≤ 15초
string
단일 참조 오디오 (
audio_urls 의 단일 값 형태)string
참조 문서 URL, 최대 1개.
link_url 과 함께 사용 불가.형식: docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md 등, ≤100MB, ≤50페이지.string
공개 웹 페이지 URL, 최대 1개. 로그인 불필요 페이지만.
file_url 과 함께 사용 불가.미디어 계열 상호 배제
미디어는 두 계열 중 하나이며 혼합 불가 (제출 전 검증 → 400, 작업 미생성·과금 없음):순수 image_urls 할당 방식
generation_type이 있으면 → 그것을 사용 (frame/reference)- 없고 요청에 참조 계열 입력이 있으면 (
video_urls/audio_urls/audio_url/file_url/link_url) →reference_image로 처리 - 둘 다 아니면 → 프레임 계열: 1번째
first_frame, 2번째last_frame(wan2.7과 동일)
image_with_roles 를 사용하세요.
미디어 제한 및 형식
요청 예시
텍스트→동영상
첫 프레임→동영상
첫·마지막 프레임
image_with_roles 사용:
멀티모달 참조
video_urls가 있으면 순수image_urls는 참조 이미지로 자동 분류됩니다.generation_type: "reference"를 명시하면 더 명확합니다.
파일 참조→동영상
prompt 는 생략 가능. 문서 내용으로 생성이 구동됩니다:
웹 페이지 참조→동영상
요금
초 × 해상도 (공식 리스트 가격 기준). 오디오 온/오프는 가격에 영향 없음:- 기본값은 1080P (가장 비쌈). 비용에 민감하면
480P/720P지정 - 과금 초수 = 요청한
duration audio: true/false는 가격에 영향 없음
제한 및 참고
자주 발생하는 오류
모두 동기 400 (작업 미생성·과금 없음):Response
integer
상태 코드. 성공 시 200
array
응답 데이터 배열
결과 조회동영상 생성은 비동기입니다. 작업 상태 조회 또는
GET /v1/videos/generations/{task_id} 로 폴링하세요.권장 간격 5–10초. 생성은 보통 1–5분 소요. 성공 후 result.videos 의 URL 을 사용하세요.