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.0 | Wan 3.0 | はい |
オプション
Wan 3.0のパラメーター
全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。
| フィールド | 値 |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 2, 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
Wan Video v2.2 API
Lightningバリアントも選べるオープンウェイトの動画生成
Berry API
参照に忠実な動画を生成
Blueberry API
最初と最後のフレームを固定
Cherry API
フラッグシップの動画モデルファミリー
Grok Video API
Grok Imagineが動き出す
Kiwi API
設定いらずで日常使いの動画生成
FAQ
よくある質問
Wan 3.0 APIの料金はいくらですか?
Wan 3.0 APIのエンドポイントは?
Wan 3.0ではどのモデルを呼び出せますか?
Wan 3.0は参照画像やキャラクターに対応していますか?
ClaudeやChatGPTからWan 3.0を使えますか?
Wan 3.0の生成結果はどのくらい保存されますか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。