Wan 3.0 Prime API — Python 래퍼

MuAPI의 Wan 3.0 Prime API를 위한 전용 Python SDK 및 MCP 서버입니다. Wan 3.0 Prime은 Wan 3.0의 고화질 등급으로, 초당 요금이 더 높은 대신 더 선명한 디테일과 안정적인 모션을 제공합니다. text-to-video, image-to-video, 멀티모달 reference-to-video(참조 이미지 최대 10개, 참조 비디오 최대 5개, 참조 오디오 최대 5개), 동기화된 오디오, 파일 업로드, 비동기 작업 폴링을 지원합니다.

관련 프로젝트

• Wan 3.0 Prime on MuAPI — Wan 3.0 및 Wan 3.0 Prime 비디오 생성 등급의 모델 랜딩 페이지입니다.

• Wan 3.0 Prime Text to Video playground — 브라우저에서 모델을 직접 시험해 볼 수 있습니다.

• MuAPI API reference — 엔드포인트 및 예측 수명주기 문서입니다.

• Wan-3.0-API — 이 저장소가 미러링하는 표준 등급 Wan 3.0 Python SDK 및 MCP 서버입니다.

• wan-3.0-comfyui — MuAPI를 통한 Wan 3.0용 ComfyUI 커스텀 노드입니다.

• awesome-ai-video-models — API, 가격, 속도별로 AI 비디오 모델을 비교합니다.

• Open-Generative-AI — 이미지 및 비디오 워크플로를 위한 오픈소스 AI 미디어 스튜디오입니다.

• Seedance-2-API — ByteDance Seedance 비디오 생성용 Python SDK입니다.

• Veo-4-API — Google Veo AI 비디오 생성을 위한 Python SDK.

• Flux-3-Dev-API — FLUX 3 이미지 및 비디오 생성을 위한 Python SDK.

• Generative-Media-Skills — 자동화된 미디어 워크플로를 위한 에이전트 바로 사용 가능한 스킬입니다.

• muapi-cli — MuAPI 이미지, 비디오, 오디오 모델에 대한 명령줄 접근을 제공합니다.

Related MCP server: NoLang MCP Server

설치

git clone https://github.com/Anil-matcha/Wan-3.0-Prime-API.git
cd Wan-3.0-Prime-API
pip install -r requirements.txt
cp .env.example .env

.env 파일에 MUAPI_API_KEY를 설정하세요. 기본 MuAPI base URL이 아닌 호환 가능한 다른 프로바이더를 사용하는 경우에만 WAN_PRIME_API_BASE_URL을 설정하세요.

빠른 시작

from wan_api import WanPrimeAPI

api = WanPrimeAPI()
job = api.text_to_video(
    "A cinematic tracking shot of a red fox crossing a snowy forest at sunrise",
    resolution="720p",
    aspect_ratio="16:9",
    duration=5,
)

result = api.wait_for_completion(job["request_id"])
print(result)

이미지를 비디오로

job = api.image_to_video(
    prompt="The subject turns toward camera as a gentle breeze moves their hair.",
    image_url="https://example.com/reference.jpg",
    aspect_ratio="9:16",
    duration=5,
)

참조를 비디오로

job = api.reference_to_video(
    prompt="The person from the reference image walks into the room shown in the reference video.",
    images_list=["https://example.com/character.jpg"],
    videos_list=["https://example.com/room.mp4"],
    resolution="720p",
    duration=5,
)

API 개요

모든 메서드는 resolution(480p, 720p, 1080p), duration(2~30초), thinking_mode(복잡한 프롬프트에 대한 더 깊은 추론), enable_audio, seed 인자도 받습니다.

Wan 3.0 Prime vs. 표준 Wan 3.0

Wan 3.0 Prime은 표준 Wan 3.0과 완전히 동일한 요청 형태를 제공합니다. 즉 text-to-video, image-to-video, reference-to-video 전반에 걸쳐 동일한 prompt, resolution, aspect_ratio, duration, thinking_mode, enable_audio, seed 파라미터를 사용하며, 단지 wan3.0-* 대신 wan3.0-prime-* 엔드포인트를 바라볼 뿐입니다. 더 높은 선명도와 모션 일관성이 더 높은 요금을 정당화하는 히어로 콘텐츠, 고객 전달물, 캠페인 최종본에 사용하세요. 일상적인 생성에는 Wan-3.0-API를 사용하십시오.

MuAPI 참고 요금(출력 1초당, 해상도 및 지속 시간에 따라 과금):

MCP 서버

Wan Prime 도구를 MCP 지원 클라이언트에 노출합니다:

python mcp_server.py

서버는 text_to_video, image_to_video, reference_to_video, get_task_status 도구를 제공합니다.

엔드포인트 호환성

클라이언트는 WAN_PRIME_API_BASE_URL 하위의 wan3.0-prime-text-to-video, wan3.0-prime-image-to-video, wan3.0-prime-reference-to-video 경로들를 사용합니다. 프로바이더가 엔드포인트 이름을 다르게 지명한다면, 그 프로바이더와 호환되는 base URL을 전달하거나, 사용 전에 작은 클라이언트 모듈을 조정하세요.

라이선스

MIT