Mage API · 動画生成
テキストや画像から作れるAI動画生成API
テキストから動画、画像から動画、最初と最後のフレームから動画、参照から動画まで、15モデルに対応。Mageのフラッグシップ、Cherry 2 Proを中心に、多くのクリップで音声も生成できます。
POST https://api.mage.space/v1/{model}/generateひと目でわかる概要
Mageの動画生成APIは、https://api.mage.space/v1で提供されるREST APIで、Cherry 2 Pro、Lemon、Plum、Melon、MiniMax-H3、Grok Video、Wanなど、15種類のテキストから動画・画像から動画モデルを実行できます。プロンプトと、必要に応じてフレームや参照を送信し、リクエストをポーリングして、MP4をダウンロードします。各クリップの料金は、モデル、解像度、長さに応じてGemsで支払います。
- 15動画モデル
- $0.02標準の最安価格(1クリップあたり)
- 20同時生成数
- $0月額料金
モデル
Mage APIの全動画モデル
料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。
| モデル | おすすめの用途 | model_idの値 | デフォルト価格 |
|---|---|---|---|
| Berry | 参照に忠実な動画 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 最初と最後のフレームを固定 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Mageのフラッグシップ動画シリーズ | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 動き出すGrok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 日常使いの動画を、設定なしで | kiwi | 270 Gems ($0.27) |
| Lemon | すべての動画機能を、よりお手頃な価格で | lemon | 245 Gems ($0.245) |
| LTX Video | 試行錯誤に向く高速なオープンウェイト動画 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | 動きはそのままに、どんな動画も差し替え | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | 動くアニメ、音声も追加可能 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | ステレオサウンド付きの高速オープン動画 | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | すべてのクリップに音声付き、最大2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | 最初のフレームからキャラクターに命を吹き込む | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance、厳格なフィルター付き | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0(厳格なフィルター付き) | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Lightningバリアントを備えたオープンウェイト動画 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
クイックスタート
Berry 2で動画を生成する
MAGE_API_KEYを設定してリクエストを送信し、完了するまで状態を確認します。URLのberryを上記の任意のモデルに置き換えれば、他のモデルでも使えます。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])使い方
APIキーから完成まで、たった3回の呼び出し
すべてのモデルで、認証方式、非同期リクエストの流れ、フィールド名が共通です。
APIキーを作成
Mageにサインインし、API → APIキーを開いてキーを作成します。キーはmage_sk_で始まり、表示されるのは一度だけです。1つのアカウントで有効なキーは10個まで持てます。
生成をリクエスト
Authorization: Bearerヘッダーを付けて、https://api.mage.space/v1/{model}/generateにJSONボディをPOSTします。レスポンスはすぐに返り、request_id、status、status_urlが含まれます。Idempotency-Keyヘッダーを送れば、リトライしても二重に支払うことはありません。
ポーリングしてダウンロード
statusがcompleted、failed、cancelledのいずれかになるまで、status_urlをポーリングします。完了したリクエストには、画像・動画・音声ファイルを指すresult.urlが含まれ、ファイルは30日間保存されます。
本番運用向け
すべての Mage API リクエストで使える機能
1 つのキーで全モデルに対応
1つのREST APIと1つのGems残高で使える、画像・動画・音声モデル37種。URLパスを変えるだけでモデルを切り替えられます。
生成ごとの従量課金
サブスクリプションも最低利用額もありません。Gems を購入し、リクエストごとに表示価格が差し引かれます。生成に失敗した場合は返却されます(Mage のコンテンツポリシーによりブロックされた場合を除く)。
安全な再試行
冪等キーを使えば、再送信しても二重に課金されず、元のリクエストの結果が返ります。
一貫したキャラクター
キャラクターやリファレンスを一度保存しておけば、プロンプトに @handle と書くだけで、対応するすべてのモデルで使えます。
大きなファイルも入力可能
画像・動画・音声の入力は URL またはデータ URL で送信できます。署名付きアップロードなら最大 100 MB のファイルもアップロード可能です。
20 件の同時生成
1 アカウントで 20 件まで同時に生成できます。上限はご利用内容に応じて引き上げることも可能です。拒否されたリクエストに課金されることはありません。
ユースケース
開発者が動画APIで作っているもの
ショート動画とSNS動画
プロンプトや商品画像から、TikTok、リール、ショート向けの縦型クリップを作成できます。
静止画を動かす
LemonやKiwiなどの画像から動画モデルで、最初のフレーム、または最初と最後のフレームから動きを作れます。
キャラクター主導のストーリー
@handleのキャラクターを使える参照から動画モデルで、ショットをまたいで同じキャラクターを保てます。
音声付き動画
Plumなどのモデルは、映像と一緒にセリフ、効果音、環境音を生成し、声の音声リファレンスにも対応しています。
広告と商品デモ
CMのバリエーションをたくさん生成して最良のものを選べます。冪等な送信なので、二重課金の心配もありません。
既存のクリップを編集
Berry、Plum、Grok Videoは、送信した元の動画を編集できます。LemonとMiniMax-H3は参照動画も使えます。
FAQ
よくある質問
最適なAI動画生成APIは?
動画APIは画像から動画に対応していますか?
生成できる動画の長さはどのくらいですか?
動画の生成にはどのくらい時間がかかりますか?
Mage API の料金はいくらですか?
API を使うには Mage のメンバーシップが必要ですか?
API で生成したものは商用利用できますか?
レート制限はどうなっていますか?
AIエージェントからMage APIを使えますか?
Mage API用のSDKはありますか?
すでに別の生成APIを使っています。何を変更すればいいですか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。