Wan API

8개 영상 모델, 하나의 키

Wan 3.0·Wan 3.0 Prime·Wan 3.0 Pro·Wan 3.0 Prime Pro 네 가지 변형과 Seedance 2.5·2.0·2.0 Fast·2.0 Mini가 같은 플랫폼에 있습니다. GET /v1/models는 현재 키로 이용 가능한 모델을 반환하며, 각 모델은 wan3.0-video, w3.0-video-prime-pro 처럼 문서화된 모델 ID를 가집니다.

멀티모달 입력 방식

텍스트 프롬프트만 보내거나, 첫·마지막 프레임을 주거나, 참고 자료(이미지 최대 10장, 영상 5클립, 오디오 5클립)로 지시할 수 있습니다. 문서 한 장이나 공개 웹페이지 입력도 지원됩니다. 키프레임 모드와 레퍼런스 모드는 분리되어 한 요청에 섞을 수 없고, 프롬프트는 20,000자까지입니다.

네이티브 요청 미리보기가 있는 Playground

각 모델 페이지에는 Playground가 내장되어 선택 모델용 평면 네이티브 요청 본문을 조립하고, 비워 둔 선택 필드는 넣지 않으며, 제출 전 해당 모델의 생성 가능 여부를 확인합니다. 웹사이트 세션과 선불 잔액을 그대로 쓰므로 키를 브라우저에 붙여 넣을 필요가 없습니다.

비동기 태스크 API

모델 엔드포인트로 제출하면 공개 태스크 ID가 즉시 반환됩니다. 상태는 pending, processing, completed, failed이며, 완료 응답에는 서명된 Bunny CDN URL이 담겨 Authorization 헤더 없이 재생·다운로드할 수 있습니다. POST /v1/responses는 동기 대기, 백그라운드, server-sent events 세 가지를 지원합니다.

콘텐츠 심사 단계로 단가 조절

선택 필드 nsfw_checker는 Wan 3.0과 Wan 3.0 Prime에서 엄격한 심사와 비교적 관대한 심사를 나누며, 단계별 초당 요금이 다릅니다. Pro 변형은 false만 지원합니다. 심사에서 명시적으로 거부된 요청은 같은 공개 모델 ID를 유지한 채 다른 값으로 다시 제출할 수 있습니다.

잔액 조회와 태스크 정리

GET /v1/balance는 계정에서 쓸 수 있는 잔액과 해당 키의 남은 한도를 반환합니다. DELETE /v1/tasks/{task_id}는 종료된 태스크 한 건과 저장된 영상·마지막 프레임 파일을 삭제합니다. 사이트 본문은 /llms.txt와 /llms-full.txt로 기계 판독 형식도 제공합니다.

• 이커머스·프로덕트 팀: 제품 정지 사진을 느린 궤도·줌 인으로 바꿔 형태·반사·라벨이 유지됐는지 확인한 뒤 캠페인에 쓴다.
• 각본·스토리보드·소셜 편집: 촬영도 키프레임 아트도 없는 단계에서 문장 장면을 영상 미리보기로 만들고, 짧은 클립으로 조명·카메라 방향·템포를 판단해 본편 길이를 정한다.
• 브리프 기반 에이전시: 짧은 문서나 공개 페이지를 입력해 대상 고객과 전할 메시지 하나에 집중한 영상 출발점을 만든다.
• 영상 API를 통합하는 엔지니어링 팀: Wan과 Seedance의 단가·길이·레퍼런스 한도를 나란히 비교하고, 고른 모델을 하나의 키와 잔액으로 계속 쓴다.
• 레퍼런스로 캐릭터를 잡는 작업: 업로드한 자산마다 외형·움직임·소리라는 역할을 지정해 Seedance 2.5의 긴 장면에서도 인물과 장소가 구분되게 한다.

알리바바나 ByteDance 공식 서비스인가요?

아닙니다. Wan API는 wanapi.app에서 독립 운영되며 Alibaba·Wan·ByteDance와 소속 또는 추천 관계가 없습니다. 해당 명칭은 연결된 제3자 모델을 가리키며 상표는 각 소유자에 있습니다.

영상 생성에 구독이 필요한가요?

월간 영상 패키지는 안내되어 있지 않습니다. 생성 여부는 활성화되고 잔액이 있는 계정에 달리고, 요금은 해상도 단가 × 과금 초입니다.

과금되는 초는 무엇인가요?

레퍼런스 영상 입력 초와 생성 출력 초의 합계입니다. 텍스트·이미지·오디오는 초를 더하지 않으며 생성 오디오를 꺼도 단가는 내려가지 않습니다.

태스크 취소나 자동 재시도가 되나요?

취소·webhook·멱등 키 계약이 안내되지 않았고, 제출이 자동으로 재시도되거나 다른 모델로 전환되지 않습니다. 타임아웃이나 ID 미수령 시에는 기존 태스크를 먼저 조회하세요. POST를 다시 하면 유료 태스크가 두 개가 될 수 있습니다.

생성 영상은 얼마나 보관되나요?

완료된 태스크는 키 없이 쓰는 서명 CDN URL을 주지만, 파일은 플랫폼 보관 정책이 적용됩니다. 조회해도 제공 기간은 늘어나지 않으니 남길 파일은 자체 저장소에 복사하세요.

첫 테스트에는 어떤 모델이 알맞나요?

Wan 3.0은 480p~1080p로 가장 저렴한 구간, Prime은 별도 가격의 별개 모델, 2K와 4K는 Pro 계열만 지원합니다. Seedance 각 페이지는 길이·레퍼런스 한도가 다르므로 요구 사항에 맞춰 고르고, 저렴한 모델에 고해상도가 있으리라 가정하지 마세요.

요청 본문을 모델 간에 재사용할 수 있나요?

네 Wan 모델은 14개 네이티브 생성 필드를 공유하지만 해상도 값, 모델 ID, nsfw_checker 지원 여부가 다릅니다. Pro 변형은 관대한 값만 지원합니다. 알 수 없는 필드는 거부되니 대상 모델 페이지를 먼저 확인하세요.

• Google로 wanapi.app에 로그인하고 계정 설정에서 충전한다. 사이트 계정만 있어서는 영상 생성이 열리지 않는다.
• API 키 설정에서 키를 만들어 서버 쪽에만 보관한다. Playground는 웹사이트 세션과 같은 잔액을 쓰므로 키가 필요 없다.
• 모델 목록이나 GET /v1/models에서 대상을 고른 뒤, 그 모델 페이지에서 지원 해상도·길이 범위·레퍼런스 한도를 확인한다.
• 해당 모델의 Playground에서 요청을 작성하고 미리보기 네이티브 본문을 복사한다. 문서화된 모델 ID로 JSON을 직접 짜도 된다.
• 제출하면 반환된 태스크 ID를 바로 저장하고 5초 간격부터 폴링을 시작하며, 임시 오류가 이어지면 간격을 늘린다.
• 완료 응답의 서명된 URL로 재생·다운로드하고, 보관 기간이 끝나기 전에 자체 저장소로 복사한다.