メインコンテンツへスキップ

Mage API · 動画モデル

Wan 3.0 API

Wan 3.0(厳格なフィルター付き)

POST https://api.mage.space/v1/wan_3/generate

ひと目でわかる概要

Wan 3.0 APIは、POST https://api.mage.space/v1/wan_3/generate を通じてMage上でWan 3.0を実行します。デフォルト設定のリクエストは245 Gems(約$0.245)で、サブスクリプションは不要です。Wan 3.0では、プロンプト内で@handleを使って、保存したキャラクター、リファレンス、音声リファレンスを指定できます。

  • 動画出力
  • 1バリアント
  • 2451クリップあたりのGems(デフォルト)
  • $0.245米ドル換算の目安

概要

Wan 3.0 APIでできること

AlibabaのオールインワンモデルWan 3.0。開始フレームと終了フレーム、最大10件のリファレンスまたはCharacters、Voices、音声に対応し、2〜30秒のクリップを最大1080pで生成できます。厳格なフィルター:プロバイダーのコンテンツフィルターが適用されます。

AlibabaのWan 3.0は、テキスト、フレーム、参照画像、参照動画、Voicesに対応した1つの動画モデルです。音声付きで2〜30秒のクリップを生成できます。厳格なフィルター:プロバイダーのコンテンツフィルターがプロンプト、入力メディア、完成した動画をチェックします。拒否されたリクエストは理由とともに `content_blocked` で失敗し、返金されます。

入力としてfirst_image、last_image、image、additional_images、videosを受け付けます。

クイックスタート

Wan 3.0 APIを呼び出す

MAGE_API_KEYを設定し、/wan_3/generateにリクエストを送信して、完了するまでstatus_urlをポーリングします。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "wan-3.0"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('wan_3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'wan-3.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("wan_3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "wan-3.0",
})

print(request["result"]["url"])

モデル

Wan 3.0のmodel_id値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

model_id名前デフォルト
wan-3.0Wan 3.0はい

オプション

Wan 3.0のパラメーター

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

フィールド値
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

入力

Wan 3.0が受け付ける入力メディア

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

フィールド役割
first_image最初のフレームの画像。
last_image最後のフレームの画像です。
image参照画像。
additional_images追加の参照画像。
videos元となる動画。

ルール

Wan 3.0 APIの制限事項

  • 最初と最後のフレームは、参照画像や参照動画と組み合わせられません。どちらか一方のみ送信してください。
  • 参照画像は最大10枚、参照動画は最大5本です。
  • 参照動画は1本あたり1〜15秒、合計で最大15秒まで。さらに、合計の長さと `duration` の合計は最大30秒です。参照動画の秒数は、出力の秒数と同じ扱いで課金されます。

その他の動画モデル

Mageのその他の動画生成API

  • 動画 · 40 Gemから

    Wan Video v2.2 API

    Lightningバリアントも選べるオープンウェイトの動画生成

  • 動画 · 189 Gemから

    Berry API

    参照に忠実な動画を生成

  • 動画 · 360 Gemから

    Blueberry API

    最初と最後のフレームを固定

  • 動画 · 618 Gems から

    Cherry API

    フラッグシップの動画モデルファミリー

  • 動画 · 375 Gemから

    Grok Video API

    Grok Imagineが動き出す

  • 動画 · 270 Gemから

    Kiwi API

    設定いらずで日常使いの動画生成

FAQ

よくある質問

Wan 3.0 APIの料金はいくらですか?
デフォルト設定(Wan 3.0)でのWan 3.0リクエストは245 Gems、約$0.245です。解像度、長さ、バリエーションによって料金は変わり、正確な請求額はレスポンスに含まれます。生成に失敗した場合はGemsが返却されますが、Mageのコンテンツポリシーによりブロックされた場合は返却されません。
Wan 3.0 APIのエンドポイントは?
MageのAPIキーを入れたAuthorization: Bearerヘッダーをつけて、POST https://api.mage.space/v1/wan_3/generate にリクエストします。レスポンスには、結果をポーリングするためのstatus_urlが含まれます。
Wan 3.0ではどのモデルを呼び出せますか?
wan-3.0(Wan 3.0)です。デフォルトはWan 3.0です。
Wan 3.0は参照画像やキャラクターに対応していますか?
Wan 3.0は、first_image、last_image、image、additional_images、videosを受け付けます。また、プロンプト内で@handleを使って、保存したキャラクター、リファレンス、音声リファレンスを指定できます。
ClaudeやChatGPTからWan 3.0を使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Wan 3.0を名前で指定してください。アシスタントはget_modelでオプションを読み取り、生成前に料金を伝えます。
Wan 3.0の生成結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。