APIMaster.ai

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를 확인한 후 요청을 수정하세요. 접수된 것을 성공으로 간주하지 마세요