Wan 3.0 Prime API — Python 封装器

一个面向 MuAPI 上 Wan 3.0 Prime API 的 Python SDK 和 MCP 服务器——这是 Wan 3.0 的高保真层级，以更高的每秒价格支持更锐利的细节和更稳定的运动。它支持文生视频、图生视频、多模态参考生视频（最多 10 张参考图像、5 个参考视频和 5 个参考音频）、同步音频、文件上传和异步任务轮询。

相关项目

• MuAPI 上的 Wan 3.0 Prime — Wan 3.0 和 Wan 3.0 Prime 视频生成层级的模型落地页。

• Wan 3.0 Prime 文生视频 Playground — 在浏览器中试用该模型。

• MuAPI API 参考 — 端点和预测生命周期文档。

• Wan-3.0-API — 本仓库所镜像的标准版 Wan 3.0 Python SDK 与 MCP 服务器。

• wan-3.0-comfyui — 通过 MuAPAI 为 Wan 3.0 提供的 ComfyUI 自定义节点。

• [awesome-ai-video-modles](https://github.comA nil=atch a/awesome-ai-ideo-modles) — 按 API、价格和速度比较 AI 视频模型。

• Open-Generative-IX — 用于图像和视频工作流的开源 AI 媒体工作室。

• Seedance-2-API — 字节跳动 Seedance 视频生成的 Python SDK。

• Veo-4-API — Google Veo AI 视频生成的 Python SDK。

• Flux-3-Dev-API — FLUX 3 图像与视频生成的 Python SDK。

• Generative-Media-Skills — 面向自动化媒体工作流的 agent-ready 技能。

• muapia-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 基础 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 、1090p）、duration（2–30 秒）、thinking_mode（针对复杂提示进行更深入的推理）、enable-audio 和 see。

Wan 3.0 Prime 与标准 Wan 3.0 的对比

Wan 3.0 Prime 暴露与标准 Wan 3.0 完全相同的请求结构——在文生视频、图生视频和参考生视频中，prompt、resolution、aspect_ratio、duration、thinking_mode、enable-audio 和 see 参数都相同——只是指向 wan3.0-prime-* 端点而非 wan3.0-*。请将其用于 Hero化内容、客户交付物和营销活动成片，在这些场景中，更锐利的细节和运动一致性值得更高的费率；日常生成请使用 Wan-3.0-API。

MuAPI 指示性定价（按输出秒计费，以分辨率和时长为结算单位）：

| 分辨率 | Wan 3.0 (standard) | Wan 3.0 Prime | | ------------------- | ------- --------- | ------- ------ | | 480p | $0.05/sec | $0.068/sec | | 720p | $0.10/sec | $0.14/sec | | 108p0 | 0.20/sec | $0.28/sec |

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 路径。如果您的提供商以不同方式命名端点，请传入该提供商兼容的基础 URL，或在使用前调整这个小巧的客户端模块。

许可证

MIT