Wan API 시작하기

REST API를 사용하면 Wan AI 비디오 생성을 애플리케이션에 쉽게 통합할 수 있습니다. SaaS 제품, 모바일 앱, 웹 플랫폼 등 모든 애플리케이션에 비디오 생성 기능을 통합하는 방법을 소개합니다.

먼저 플랫폼(DashScope)에서 API 키에 등록하세요. 매월 일정 횟수의 무료 티어가 제공되어 개발과 테스트에 충분합니다. API 키는 대시보드에서 생성 및 관리할 수 있으며, 환경 변수(DASHSCOPE_API_KEY)로 설정하는 것을 권장합니다.

기본 워크플로우는 세 단계로 구성됩니다. 1단계: 생성 요청 제출. 2단계: 작업 ID로 상태 폴링. 3단계: 완성된 비디오 URL을 받아 다운로드. Python, JavaScript, Go용 공식 SDK 패키지가 이 과정을 단순화합니다.

텍스트에서 비디오 생성의 경우, 프롬프트와 원하는 파라미터(해상도, 프레임레이트, 비디오 길이 등)를 포함한 POST 요청을 /v1/generate 엔드포인트로 보냅니다. 응답에는 추적을 위한 작업 ID가 포함됩니다. Python의 경우: response = client.video_generation(model='wan-2.6-14b', prompt='...', size='1280x720')과 같이 간단하게 호출할 수 있습니다.

이미지에서 비디오도 같은 패턴을 따르지만, 소스 이미지를 base64 인코딩 문자열로 업로드하거나 공개 URL을 제공합니다. 이미지의 권장 해상도는 생성할 비디오 해상도와 일치시키면 최상의 결과를 얻을 수 있습니다.

고급 기능으로는 생성 완료 시 지정 URL로 자동 알림하는 웹훅 콜백, 배치 처리를 통한 복수 비디오 일괄 생성, 시드값 지정을 통한 재현 가능한 생성 등이 있습니다. 속도 제한은 플랜에 따라 설정되며, 무료 플랜은 분당 5회, 유료 플랜은 분당 60회까지 대응합니다. 에러 핸들링에서는 429(속도 제한)나 503(서버 과부하)에 대한 재시도 로직 구현을 권장합니다.