Wan 3 0 API

Wan 3.0 API — Python Wrapper

[](https://muapi.ai) [](LICENSE) [](https://www.python.org/)

A focused Python SDK and MCP server for Wan 3.0-compatible AI video-generation APIs. It supports text-to-video, image-to-video, multimodal reference-to-video, file upload, and asynchronous job polling.

Related Projects

• awesome-ai-video-models — compare AI video models by API, price, and speed.
• Open-Generative-AI — open-source AI media studio for image and video workflows.
• Seedance-2-API — Python SDK for ByteDance Seedance video generation.
• Veo-4-API — Python SDK for Google Veo AI video generation.
• Flux-3-Dev-API — Python SDK for FLUX 3 image and video generation.
• Generative-Media-Skills — agent-ready skills for automated media workflows.
• muapi-cli — command-line access to MuAPI image, video, and audio models.

Install

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

Set MUAPI_API_KEY in .env. Set WAN_API_BASE_URL only if you use a compatible provider other than the default MuAPI base URL.

Quick start

from wan_api import WanAPI

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

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

Image to video

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

API surface

| Method | Purpose | | --- | --- | | text_to_video() | Create a video from a text prompt. | | image_to_video() | Animate one or more image URLs. | | reference_to_video() | Condition a video on image, video, or audio references. | | upload_file() | Upload a local reference file. | | get_result() / wait_for_completion() | Retrieve an asynchronous job's output. |

MCP server

Expose Wan tools to MCP-capable clients:

python mcp_server.py

The server provides text_to_video, image_to_video, reference_to_video, and get_task_status tools.

Endpoint compatibility

The client uses wan-3.0-t2v, wan-3.0-i2v, and wan-3.0-reference-to-video paths beneath WAN_API_BASE_URL. If your provider names its endpoints differently, pass that provider's compatible base URL or adapt the small client module before use.

License

[MIT](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Anil-matcha
• Source: Anil-matcha/Wan-3.0-API
• License: MIT
• Homepage: https://muapi.ai/wan-3

Install and usage instructions live in the source repository linked above.