Wan 3.0 Prime API MCP Server
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: wan-mcp
설치
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 개요
메서드 | 용도 |
| 텍스트 프롬프트에서 동기화된 오디오가 포함된 고화질 비디오를 생성합니다. |
| 원본 이미지에 애니메이션을 적용하며, |
| 참조 이미지 최대 10개, 참조 비디오 최대 5개, 참조 오디오 최대 5개를 기반으로 비디오를 생성합니다. |
| 로컬 참조 파일을 업로드합니다. |
| 비동기 작업의 출력 결과를 가져옵니다. |
모든 메서드는 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초당, 해상도 및 지속 시간에 따라 과금):
해상도 | 표준 Wan 3.0 | Wan 3.0 Prime |
480p | $0.05/초 | $0.068/초 |
720p | $0.10/초 | $0.14/초 |
1080p | $0.20/초 | $0.28/초 |
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을 전달하거나, 사용 전에 작은 클라이언트 모듈을 조정하세요.
라이선스
This server cannot be deployed
Maintenance
Related MCP Connectors
Plan, compare, price, generate, and recover AI video from compatible MCP clients.
MCP server for Wan AI video generation
Generate AI video from any MCP client. Pick the model, see the per-second price before you spend.
Build, run, schedule, and publish AI video pipelines to YouTube and TikTok from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn async video generation MCP server with multi-provider support. Currently in skeleton phase with stub implementations, it will eventually enable video generation through providers like Veo 3.1, Grok Imagine Video, and Sora 2 Pro.MIT
- AlicenseBqualityAmaintenanceMCP server for the Wan model line enabling AI-driven animation, video editing, and image/video generation tasks via RunAPI with status polling and pricing.9285 npmApache 2.0
- AlicenseAqualityAmaintenanceMCP server for MiniMax H3 multimodal video generation. Enables text-to-video, image-to-video, and audio-guided video creation with async task retrieval and batch processing.102,119 PyPI1MIT
- AlicenseNot gradedqualityCmaintenanceExposes video generation and editing tools to MCP-capable clients, enabling text-to-video, image-to-video, video editing, reusable voice and character profiles, and task status queries through natural language.4MIT