동영상 생성
플랫폼 공통 필드로 Wan 3.0 텍스트·이미지·멀티모달 참조 동영상 작업을 생성합니다.
플랫폼 형식은 최상위 공통 매개변수와 metadata를 사용합니다. 네이티브 input/parameters를 직접 넣지 마세요. 생성은 비동기로 처리되며 제출 후 결과를 조회합니다.
/v1/videos인증
bearerAuth 플랫폼 API Key 사용: Authorization: Bearer your-api-key.
전달 위치: header
요청 본문
application/json
TypeScript 타입 정의
TypeScript에서 request body 타입을 사용하세요.
프롬프트 또는 비어 있지 않은 metadata.media가 필요합니다. JSON을 사용하며 multipart/input_reference/image/images는 사용하지 않습니다.
응답 본문
application/json
application/json
application/json
매개변수와 우선순위
| 설정 | 입력 및 우선순위 |
|---|---|
| 프롬프트와 소재 | prompt 또는 비어 있지 않은 metadata.media가 필요합니다. 이미지에 최상위 image/images/input_reference를 사용하지 않습니다 |
| 해상도 | 비어 있지 않은 size → 비어 있지 않은 metadata.resolution → 비어 있지 않은 metadata.size → 1080P; 픽셀 크기가 아닌 등급을 입력합니다 |
| 길이 | 명시한 duration → 비어 있지 않은 seconds → metadata.duration → 5; duration은 정수, seconds는 정수 문자열입니다 |
| 시드 | 명시한 최상위 seed가 metadata.seed보다 우선하며 0도 유효합니다 |
| 기타 | 화면 비율, 소리, 재작성, 워터마크는 metadata에 넣습니다. 명시한 false는 유지됩니다 |
설정마다 한 가지 방법만 사용하세요. 해상도와 seconds의 공백 문자열은 생략으로 처리하며 소재가 있으면 prompt를 생략할 수 있습니다. 잘못된 상위 값은 오류를 반환하며 하위 값으로 자동 대체하지 않습니다.
시나리오와 소재
요청 예시는 텍스트, 시작 프레임, 시작·끝 프레임, 혼합 참조, 파일, 웹페이지, 편집, 연장을 제공합니다. 소재 시나리오에서는 예시 주소를 접근 가능한 본인 URL로 교체하세요.
시작·끝 프레임 모드에는 참조 소재를 함께 넣을 수 없으며 끝 프레임에는 시작 프레임이 필요합니다. 파일과 웹페이지 중 하나를 선택하고 프롬프트 재작성을 켜세요. 형식, 수량, 크기, 길이는 소재 및 조합 규칙을 확인하세요. 플랫폼 형식에도 같은 규칙이 적용됩니다.
생성 결과와 호환 경로
생성 시 video 객체가 반환됩니다. id를 저장하고 플랫폼 조회 API로 결과를 가져오세요. 호환 필드 task_id는 id와 같습니다. queued는 접수이며 생성 완료가 아닙니다.
POST /v1/video/generations와 POST /v1/videos/generations도 같은 매개변수·응답 구조로 지원합니다. 신규 연동은 기본 경로 POST /v1/videos를 사용하세요.
자주 발생하는 오류
HTTP 400이면 오류 내용에 따라 매개변수 형식, 해상도, 소재 조합, metadata 필드 이름을 확인하세요. 오류는 code/message/data 또는 중첩된 error 객체에 있을 수 있습니다.