Wan 3.0 비디오 API
APIMaster의 wan3.0-video에 대한 매개변수, 미디어 조합, 비동기 작업, 다운로드 및 초당 과금.
Wan 3.0 비디오 API
wan3.0-video는 표준 Wan 3 모델이며, wan3.0-video-prime과는 별개의 모델입니다. 텍스트, 이미지, 비디오, 오디오, 문서 및 공개 웹 페이지를 지원합니다. 성공한 각 작업은 최대 30초 길이의 MP4/H.264 비디오 하나를 생성합니다. 통합 검토일: 2026-11-17.
요청당 미디어는 총 20개까지 사용할 수 있습니다. 생성 영상의 프레임 속도는 30 fps입니다.
엔드포인트 및 인증
| 작업 | 엔드포인트 |
|---|---|
| 생성 | POST https://apimaster.ai/v1/videos |
| 조회 | GET https://apimaster.ai/v1/videos/{task_id} |
| 다운로드 | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
모든 요청 파라미터
요청당 미디어 형식 하나를 사용하세요. 여러 참조 미디어나 문서는 metadata.input.media를 사용하세요.
| 파라미터 | 타입 | 필수 / 기본값 | 의미 및 유효 값 |
|---|---|---|---|
model |
string | 필수 | 정확히 wan3.0-video; Prime으로 대체하지 마십시오 |
prompt |
string | 필수 | 결과를 중국어 또는 영어로 설명; 공식 제한은 20,000자이며, 더 긴 네이티브 텍스트는 잘립니다. 미디어 순서에 따라 Image 1, Video 1, Audio 1을 참조하십시오; 각 미디어 유형은 고유한 번호 체계를 가집니다 |
duration |
integer | 5 |
2–30 출력 초; -1은 모델이 길이를 선택하도록 합니다. 참조 비디오가 있는 경우 입력과 출력 길이의 합이 30초를 초과할 수 없습니다 |
seconds |
string | 선택 | duration 별칭, 예: "5" 또는 "-1"; 둘 다 제공되는 경우 duration과 일치해야 합니다 |
resolution |
string | 1080P |
480P, 720P, 1080P; 소문자 최상위 값은 정규화됩니다 |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | 선택 | aspect_ratio의 별칭; 비디오 확장에는 adaptive를 권장합니다 |
size |
string | 선택 | 호환 별칭: 해상도 등급 또는 1280x720과 같이 지원되는 픽셀 매핑; 임의의 픽셀 크기보다 명시적인 resolution과 ratio를 선호하십시오 |
generate_audio |
boolean | 업스트림 true |
출력에 오디오 트랙이 있는지 여부. 명시적 false는 유지됩니다. 오디오는 초당 요금을 변경하지 않습니다 |
audio |
boolean | 선택 | generate_audio의 별칭; 오디오 스위치는 하나만 사용하십시오 |
prompt_extend |
boolean | true |
지능형 프롬프트 재작성; 명시적 false는 유지됩니다. 문서/페이지 입력에는 true여야 합니다 |
watermark |
boolean | 업스트림 false |
출력에 워터마크 추가; 명시적 false는 유지됩니다 |
seed |
integer | 무작위 | -1 또는 0–2147483647. 생략하거나 -1을 지정하면 무작위 시드를 요청합니다; 0은 그대로 전달됩니다. 동일한 시드를 반복해도 동일한 출력이 보장되지 않습니다 |
input_reference |
string | 선택 | 첫 프레임 이미지 URL; 네이티브 미디어 배열을 대체합니다. 입력 스타일을 혼용하지 마십시오 |
images |
string[] | 선택 | input_reference가 없을 때 reference_image 항목으로 추가되는 편의 배열 |
metadata |
object | 선택 | 아래 네이티브 객체를 담는 컨테이너; 선택된 모델을 변경할 수 없습니다 |
metadata.input |
object | 선택 | 네이티브 입력 객체 |
metadata.input.prompt |
string | 선택 | 네이티브 프롬프트 재정의; 필수 최상위 prompt는 유지하십시오 |
metadata.input.media |
object[] | 선택 | 순서가 있는 미디어 배열. 각 항목에는 type과 url이 필요합니다; 아래 제한을 참조하십시오 |
metadata.input.media[].type |
string | 항목당 필수 | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | 항목당 필수 | 공개 HTTP(S) 미디어 URL; 이미지 유형은 data:{MIME_type};base64,... 문자열도 허용합니다. 비이미지 미디어는 공개 URL이 필요합니다 |
metadata.parameters |
object | 선택 | 네이티브 파라미터 객체; null일 수 없습니다 |
metadata.parameters.resolution |
string | 1080P |
대문자 480P, 720P, 1080P |
metadata.parameters.ratio |
string | adaptive |
위에 나열된 것과 동일한 화면비 값 |
metadata.parameters.duration |
integer | 5 |
2–30 또는 -1; 동일한 결합 길이 제약 |
metadata.parameters.audio |
boolean | 업스트림 true |
동일한 출력 오디오 스위치 |
metadata.parameters.prompt_extend |
boolean | true |
동일한 프롬프트 재작성 스위치; file/link에는 true가 필요합니다 |
metadata.parameters.watermark |
boolean | 업스트림 false |
동일한 워터마크 스위치 |
metadata.parameters.seed |
integer | 무작위 | 명시적 0을 포함한 동일한 시드 범위 |
네이티브 negative_prompt, img_url, first_frame_url, last_frame_url, audio_url 필드는 Wan 3의 미디어 제어 수단이 아닙니다. 대신 문서화된 미디어 배열을 사용하십시오.
미디어 제한 및 유효한 조합
| 미디어 유형 | 개수 및 제약 |
|---|---|
first_frame, last_frame |
각각 최대 1개. 마지막 프레임은 첫 프레임이 필요합니다. 프레임 제어는 참조, 파일 또는 링크 유형과 함께 사용할 수 없습니다 |
reference_image |
최대 10개. JPEG/JPG, 투명도 없는 PNG, BMP 또는 WEBP; 각 변 240–8,000픽셀, 가로세로 비율 최대 8:1, 각 파일 최대 20 MB |
reference_video |
최대 5개의 MP4/MOV 클립; 각 1–15초, 결합 입력 최대 15초; 최소 16 fps; 각 변 240–4,096픽셀, 가로세로 비율 최대 8:1, 각 파일 최대 100 MB |
reference_audio |
최대 5개의 WAV/MP3 클립; 각 1–15초, 결합 최대 15초; 각 파일 최대 15 MB |
file |
최대 1개의 DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD 파일; 최대 100 MB. PDF, DOCX, DOC, PPTX, PPT 및 KEY/PAGES 페이지 문서는 50페이지 제한이 있습니다 |
link |
로그인 없이 공개적으로 접근 가능한 페이지 최대 1개; file과 함께 사용하지 마세요 |
참조 이미지, 비디오 및 오디오는 함께 결합할 수 있습니다. 파일 또는 링크는 참조 미디어와 함께 제공될 수 있습니다. 첫/마지막 프레임 모드는 프레임 제어만 허용합니다. 오디오 기반 생성에는 참조 이미지 + 참조 오디오 모드를 사용하세요. 미디어 파싱 및 콘텐츠 검열은 업스트림 검사 대상으로 유지됩니다.
텍스트-투-비디오는 미디어 없이 프롬프트를 사용합니다. 첫 프레임 애니메이션은 first_frame을 사용하고, 전환은 first_frame과 last_frame을 사용합니다. 참조 생성은 참조 유형을 사용합니다. 편집 또는 확장의 경우 reference_video를 제공하고 프롬프트에 편집 또는 확장 내용을 설명하세요. 확장에는 adaptive를 사용하세요.
예시
텍스트-투-비디오
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
첫 프레임과 마지막 프레임
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
참조 이미지 및 오디오
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}
비디오 편집 / 확장 및 스마트 길이
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
문서 / 웹 페이지
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
모든 예시 URL을 실제 공개 미디어로 교체하세요. 웹 입력의 경우 파일 항목을 {"type":"link","url":"https://example.com/product"}로 교체하세요. 첫 프레임 예시는 마지막 프레임 항목이 없어도 작동합니다.
응답, 폴링, 다운로드 및 로그
생성 요청은 업스트림 ID가 아닌 APIMaster 작업 ID를 반환합니다.
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| 응답 필드 | 의미 |
|---|---|
id / task_id |
조회 및 다운로드에 사용되는 플랫폼 작업 식별자 |
status |
queued, in_progress, completed, failed |
progress |
진행 상태 표시자이며, 종료 상태가 될 때까지 기다립니다 |
error.code, error.message |
해당하는 경우의 실패 정보 |
metadata.url |
완료 시 반환되는 콘텐츠 위치 |
동일한 API 키를 사용하여 약 15초마다 폴링하십시오. 진행 상황을 확인하기 위해 또 다른 작업을 생성하지 마십시오. 네이티브 제공자의 작업 ID와 출력 URL은 24시간 후에 만료되므로, 성공한 결과를 즉시 다운로드하여 보관하십시오. 임시 업스트림 URL을 저장하는 대신 APIMaster의 인증된 콘텐츠 엔드포인트를 사용하는 것이 권장됩니다.
curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4
사용 로그에는 작업과 성공한 비디오 결과가 포함됩니다. 완료 후 최종 청구 금액을 확인하십시오. 접수는 생성 성공의 증거가 아닙니다. 반복 폴링은 추가 생성 요금을 발생시키지 않습니다.
청구
초당 요금은 다음에서 확인하세요 모델 카드.
APIMaster는 모든 입력 동영상과 출력 동영상의 길이를 합산하고 합계를 정수 초로 한 번 올림한 뒤 선택한 출력 해상도의 초당 요금을 곱합니다. 입력 2.3초와 출력 5초는 8초로 청구됩니다. 입력 동영상이 없으면 출력 길이만 청구됩니다. 별도 견적이나 입력 길이 기입은 필요 없습니다. 생성에 실패하면 사전 차감액이 반환됩니다. 최종 금액은 사용 기록에서 확인할 수 있습니다.
오류 및 수정
| 증상 | 수정 방법 |
|---|---|
| 유효하지 않은 길이/해상도/비율 | 위의 enum과 범위를 사용하세요. 스마트 길이는 정확히 -1입니다 |
| 프레임/참조 충돌, 첫 프레임 없이 마지막 프레임 지정 | 조합 규칙을 따르세요 |
| 파일/링크와 리라이팅 비활성화 | prompt_extend:true로 설정하세요 |
| 미디어 가져오기/형식/길이 실패 | 모든 크기, 형식, 길이 제약을 충족하는 공개 파일을 사용하세요 |
| 프롬프트 누락 | APIMaster API에 대해 비어 있지 않은 최상위 prompt를 유지하세요 |
| 작업 실패 또는 검열됨 | error를 확인한 후 요청을 수정하세요. 접수된 것을 성공으로 간주하지 마세요 |
