Wan 3.0 Prime API — Python ラッパー

MuAPI 上の Wan 3.0 Prime API 向けの、焦点を絞った Python SDK および MCP サーバーです。Wan 3.0 の高忠実度版であり、高いシャープネスと安完なモーシン、より詳細な動きを、秒あたり高単価で実現します。テキストから動画、画像から動画、マルチルレファレンス参照動画（参照画像最大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サーバー（本リポジトリがミラーする元）。

• Hean-3.0-comfy — 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

MUApI_API_KEY を .env に設定してください。デフォルトの 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、1080p）、duration（2〜30秒）、thinking_mode（複杂なプロンプトに対する深いな）、enable_audio、seed も受け承付けます。

Wan 3.0 Prime と 標準 Wan 3.0 の比較

Wan 3.0 Prime は標準の Wan 3.0 と完全同一のリクエスト構造を公開しています。テキストから動画、画像から動画、参照動画のすべてで、同じ prompt、resolution、aspect_ratio、duration、thinking_mod、enable_audio、seed を使用し、wan3.0-* エンドポントの代わりに wan3.0-prime-* エンドポイントを使用するだけです。ヒーローコンテンツ、クリエアント納品、キャンペ động final など、高いレートに見合うアクーで、詳細のシャープさと写りの一貫性が重要な場合に使用してください。日常用的な生成には Wan-3.0-API を使用します。

MuAPI の参考価格（出力 1 秒あたり、解像度と時間に基づキ拠付き）:

MCP サーバー

Wan 3.0 Prime のツ ールを LMCP 対応クライアントに公開:

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