wan3.0-video API

정확한 모델 ID wan3.0-video를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력wan3.0-videoPOST /v1/videos5.0s

매개변수: duration=5resolution=1080Pratio=16:9

프롬프트: Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.

이 샘플을 생성한 요청

{
  "model": "wan3.0-video",
  "prompt": "Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/videos입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

작업 생성

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

폴링 및 다운로드

작업 ID를 저장합니다. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content로 다운로드합니다. 결과 URL은 만료될 수 있으므로 즉시 파일을 전송하세요.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

요청 메모

Wan은 일반적으로 input 및 parameters을 사용합니다. 프레임 가이드 모드와 참조 미디어 모드를 혼합하면 안 됩니다.

요청 매개변수

Wan3.0은 parameters의 출력 컨트롤과 함께 input.prompt 또는 input.media를 사용합니다. 미디어는 프레임, 참조, 오디오, 파일 또는 웹페이지를 나타낼 수 있습니다.

필드	필수	노트
model	예	wan3.0-video
input.prompt	조건부	이를 제공하거나 input.media
input.media[]	조건부	first_frame, last_frame, reference_*, file 또는 link
parameters.resolution	아니요	480P / 720P / 1080P (기본값 1080P)
parameters.ratio	아니요	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	아니요	2~30초 또는 자동 기간의 경우 -1
parameters.audio	아니요	동기화된 오디오 생성 여부
parameters.prompt_extend	아니요	이 전용 모델 계약에서 요구하는 경우 false로 설정합니다.
parameters.seed	아니요	선택적 무작위 시드
parameters.watermark	아니요	워터마크 추가 여부

입출력 제한

Wan3.0은 텍스트, 첫 번째/마지막 프레임, 최대 10개의 참조 이미지, 5개의 참조 비디오, 5개의 참조 오디오 클립 및 1개의 파일 또는 웹페이지 입력을 지원합니다. 출력은 2~30초 동안 480P, 720P, 1080P 또는 -1 자동 타이밍입니다. 첫 번째/마지막 프레임, 참조 미디어, 파일 및 웹페이지는 input.media[].type에서 선택한 상호 배타적인 워크플로우입니다.

문서화된 워크플로우 예시

Wan3.0은 텍스트, 프레임 안내, 참조 미디어, 파일 및 웹페이지에 하나의 input/parameters 봉투를 사용합니다. 이러한 워크플로는 상호 배타적입니다.

첫 번째 프레임과 마지막 프레임

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

참조 미디어

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 비동기 작업은 생성이 성공한 후 실패 상태로 들어갈 수도 있습니다. 최종 작업 사유로 폴 응답의 error_code 및 error_message을 사용합니다. 다른 JSON 형태로 동일한 요청을 재시도하지 마세요.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 초당 비디오 과금을 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.

변형

모델 ID	차이점
wan3.0-video	이 페이지에 문서화된 모델입니다.