Mage API · 次のアイデアのために
1つのAPIで、可能性は無限大。
Mageの最高の機能を、あなたのプロダクトやAIアシスタントに。1つのAPIキー、または1つのMCP接続で、画像・動画・音声を生成できます。
https://api.mage.space/v1ひと目でわかる概要
Mageは開発者向けに、https://api.mage.space/v1 のREST APIと、https://mcp.mage.space/mcp のリモートMCPサーバーを提供しています。どちらも、Mage限定のMango 4やCherry 2 Proを含む画像・動画・音声モデル37種を1つのアカウントで利用でき、生成ごとにGemsで支払います。サブスクリプションは不要です。
- 37モデル
- 3メディアの種類
- 16MCPツール
- $0月額料金
利用方法
コード、アシスタント、ComfyUIから呼び出せます
Mage API
キーを使って、自分のコードから生成をリクエスト。非同期リクエスト、冪等なリトライ、最大100 MBのアップロード、20件の同時生成に対応しています。
TypeScript・Python SDK
公式の型付きクライアントで、リクエスト送信、結果の待機、安全なリトライ、ファイルのアップロードを数行で実装できます。
Mage MCPサーバー
Claude、ChatGPT、Claude Code、Grok、Cursorにサインインで接続し、画像・動画・音声を普通の言葉で頼めます。
ComfyUI向けMage
Mango、Cherry、Seed Audioをはじめ、Mageのすべてのモデルを ComfyUIノードとして利用可能。GPUもモデルのダウンロードも不要です。
メディアの種類別
生成API
クイックスタート
はじめての生成
API → APIキーでキーを作成し、MAGE_API_KEYとしてエクスポートして、次のいずれかを実行してください。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
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日間保存されます。
MCP
AIアシスタントでMageを使おう
ClaudeでMageを使う
Claudeのウェブ版、デスクトップアプリ、モバイルアプリ、Coworkで、画像・動画・音声を生成できます。
ChatGPTでMageを使う
個人用MCPアプリとして、ChatGPTで画像・動画・音声を生成できます。
Claude Code で使う Mage
ターミナルやエディタの Claude Code で、画像・動画・音声を生成できます。
Grok で使う Mage
カスタムコネクタとして、Grok で画像・動画・音声を生成できます。
Cursor で使う Mage
Cursor のエージェントモードで、画像・動画・音声を生成できます。
モデル
注目のモデル
Flux 2 API
長いプロンプトや複数参照での編集に対応
GPT Image 2 API
的確なプロンプト反映と読みやすい文字
Guava API
写真と見間違えるほどのフォトリアリズム
Mango API
フラッグシップの画像モデルファミリー
Nano Banana 2 API
くっきり読みやすい文字、最大 4K
Cherry API
フラッグシップの動画モデルファミリー
Lemon API
すべての動画機能を、よりお手頃な価格で
Plum API
すべてのクリップに音声付き、最大 2K
Seed Audio API
ひとつのプロンプトから音声、音楽、効果音を生成
本番運用向け
すべての Mage API リクエストで使える機能
1 つのキーで全モデルに対応
1つのREST APIと1つのGems残高で使える、画像・動画・音声モデル37種。URLパスを変えるだけでモデルを切り替えられます。
生成ごとの従量課金
サブスクリプションも最低利用額もありません。Gems を購入し、リクエストごとに表示価格が差し引かれます。生成に失敗した場合は返却されます(Mage のコンテンツポリシーによりブロックされた場合を除く)。
安全な再試行
冪等キーを使えば、再送信しても二重に課金されず、元のリクエストの結果が返ります。
一貫したキャラクター
キャラクターやリファレンスを一度保存しておけば、プロンプトに @handle と書くだけで、対応するすべてのモデルで使えます。
大きなファイルも入力可能
画像・動画・音声の入力は URL またはデータ URL で送信できます。署名付きアップロードなら最大 100 MB のファイルもアップロード可能です。
20 件の同時生成
1 アカウントで 20 件まで同時に生成できます。上限はご利用内容に応じて引き上げることも可能です。拒否されたリクエストに課金されることはありません。
FAQ
よくある質問
Mage API とは?
Mage MCP サーバーとは?
MCP サーバーの利用に API キーは必要ですか?
Mage API の料金はいくらですか?
API を使うには Mage のメンバーシップが必要ですか?
API で生成したものは商用利用できますか?
レート制限はどうなっていますか?
AIエージェントからMage APIを使えますか?
Mage API用のSDKはありますか?
すでに別の生成APIを使っています。何を変更すればいいですか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。