Skip to main content
POST
Wan 3.0 올인원 비디오 생성
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
Wan 3.0의 공개 모델명은 wan3.0-video 입니다. 하나의 모델로 다음 생성 방식을 지원합니다:
  • 텍스트-투-비디오
  • 첫 프레임 또는 첫/마지막 프레임 제어
  • 레퍼런스 이미지, 레퍼런스 비디오, 레퍼런스 오디오 결합 생성
  • 파일 또는 공개 웹 페이지 레퍼런스
API는 비동기 태스크입니다. 제출에 성공하면 태스크 ID가 반환되며, 비디오 태스크 상태 엔드포인트로 진행 상황과 결과를 조회할 수 있습니다.
첫/마지막 프레임 모드와 레퍼런스 에셋 모드는 함께 사용할 수 없습니다.요청에 first_frame 또는 last_frame 이 포함된 경우 레퍼런스 이미지, 레퍼런스 비디오, 레퍼런스 오디오, 파일 또는 웹 링크를 함께 전달할 수 없습니다. 레퍼런스 이미지, 레퍼런스 비디오, 레퍼런스 오디오끼리는 조합하여 사용할 수 있습니다.

인증

string
필수
Bearer Token 인증을 사용합니다:

요청 파라미터

string
기본값:"wan3.0-video"
필수
모델 이름. wan3.0-video 로 고정됩니다.
string
비디오 내용, 피사체 동작, 카메라 워크, 사운드에 대한 설명입니다. prompt 와 미디어 에셋 중 최소 하나를 제공해야 합니다.멀티모달 레퍼런스를 사용할 때는 배열 순서에 맞춰 프롬프트에 “이미지1”, “비디오1”, “오디오1” 과 같이 작성할 수 있습니다.
integer
기본값:"5"
출력 길이. 2 ~ 30 초를 지원합니다. -1을 전달하면 스마트 길이 모드로, 모델이 프롬프트와 소재에 따라 출력 길이를 자동으로 결정합니다.
string
기본값:"adaptive"
출력 화면 비율. 다음을 지원합니다:
  • adaptive: 레퍼런스 에셋에 맞게 자동 조정
  • 16:9
  • 9:16
  • 1:1
  • 4:3
  • 3:4
호환 필드 aspect_ratio 도 사용할 수 있습니다. 두 필드를 동시에 전달할 필요는 없습니다.
string
기본값:"1080p"
출력 해상도. 480p, 720p, 1080p 를 지원합니다.
boolean
기본값:true
오디오 생성 여부. 기본값은 활성화입니다.
boolean
기본값:false
워터마크 추가 여부. 기본값은 비활성화입니다.
integer
선택적 랜덤 시드입니다. 동일한 파라미터와 시드를 사용하면 비슷한 결과를 재현하기 쉽습니다.
object[]
첫/마지막 프레임 제어 배열입니다. 각 항목은 다음을 포함합니다:
  • url: 공개적으로 접근 가능한 이미지 URL
  • role: first_frame 또는 last_frame
첫 프레임과 마지막 프레임은 각각 최대 1개씩 제공할 수 있습니다. last_frame 을 사용하려면 first_frame 도 함께 제공해야 합니다.
string[]
레퍼런스 이미지 URL 배열입니다. 최대 10 장. image_with_roles 의 첫/마지막 프레임과 함께 사용할 수 없습니다.
object[]
레퍼런스 비디오 배열입니다. 최대 5 개, 총 길이 15 초 이내. 각 항목은 다음 구조를 사용합니다:
object[]
레퍼런스 오디오 배열입니다. 최대 5 개, 총 길이 15 초 이내. 각 항목은 다음을 포함합니다:
  • url: 공개적으로 접근 가능한 오디오 URL
  • role: reference_audio 로 고정
object
파일 또는 웹 페이지 레퍼런스는 metadata.media 로 전달합니다.
로컬 이미지나 비디오는 먼저 업로드하여 공개 URL을 얻어야 합니다. 생성 요청에 로컬 파일 경로나 base64 데이터를 직접 전달하지 마세요.

에셋 조합 규칙

다음 오류가 발생하는 경우:
첫/마지막 프레임을 삭제하고 레퍼런스 에셋을 유지하거나, 모든 레퍼런스 에셋을 삭제하고 첫/마지막 프레임만 유지하세요.

요청 예시

텍스트-투-비디오

첫/마지막 프레임 비디오 생성

레퍼런스 비디오로 비디오 생성

이 요청에서는 first_frame 이나 last_frame 을 함께 전달하지 마세요.

이미지, 비디오, 오디오 결합 레퍼런스

파일 레퍼런스

응답

string
비디오 태스크 ID. 태스크 상태 조회에 사용합니다.
string
객체 타입. 일반적으로 generation.task 입니다.
string
이번 요청에 사용된 모델 이름입니다.
string
태스크 상태: queued, in_progress, completed, failed.
integer
태스크 진행률. 0 ~ 100 범위입니다.
integer
태스크 생성 타임스탬프입니다.