Skip to main content
POST

인증

string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다API 키 관리 페이지에서 API 키를 받으세요:

생성 모드

모델 이름은 wan3.0-video 로 고정. 요청 필드에 따라 모드가 결정됩니다:

요청 매개변수

기본

string
필수
고정값: wan3.0-video
string
텍스트 설명. 미디어 필드와 적어도 하나는 필수.
  • 최대 20,000자. 초과분은 오류 없이 자동 잘림
  • 참조 모드에서는 「图N / 视频N / 音频N」으로 에셋을 지정. 번호는 각 미디어 유형 내 순서를 따름
string
기본값:"1080P"
출력 해상도 (대소문자 구분 없음)
  • 480P
  • 720P
  • 1080P (기본값, 최고 요금)
resolution 을 생략하면 1080P 로 과금됩니다. 비용이 중요하면 480P 또는 720P 를 명시하세요.
string
기본값:"adaptive"
가로세로 비율. aspect_ratio 도 허용됩니다.
  • adaptive (기본값)
  • 16:9 / 4:3 / 1:1 / 3:4 / 9:16
integer
기본값:"5"
생성 길이(초), 2–30, 기본값 5
duration: -1 (스마트 길이)는 지원하지 않습니다. 2–30 정수를 전달하세요.
참조 동영상 입력이 있을 때, 입력 동영상 총 길이 + 출력 duration 은 30초 이하여야 합니다.
boolean
기본값:"true"
출력에 오디오 트랙 포함 여부. 기본값 true. 오디오 유무와 관계없이 요금 동일.
integer
난수 시드, 범위 [0, 2147483647]
boolean
기본값:"false"
워터마크 추가 여부. 기본값 false
string
순수 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페이지.
공개 웹 페이지 URL, 최대 1개. 로그인 불필요 페이지만. file_url 과 함께 사용 불가.

미디어 계열 상호 배제

미디어는 두 계열 중 하나이며 혼합 불가 (제출 전 검증 → 400, 작업 미생성·과금 없음):

순수 image_urls 할당 방식

  1. generation_type 이 있으면 → 그것을 사용 (frame / reference)
  2. 없고 요청에 참조 계열 입력이 있으면 (video_urls / audio_urls / audio_url / file_url / link_url) → reference_image 로 처리
  3. 둘 다 아니면 → 프레임 계열: 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 을 사용하세요.