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

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から呼び出せます

  • REST API

    Mage API

    キーを使って、自分のコードから生成をリクエスト。非同期リクエスト、冪等なリトライ、最大100 MBのアップロード、20件の同時生成に対応しています。

  • SDK

    TypeScript・Python SDK

    公式の型付きクライアントで、リクエスト送信、結果の待機、安全なリトライ、ファイルのアップロードを数行で実装できます。

  • MCPサーバー

    Mage MCPサーバー

    Claude、ChatGPT、Claude Code、Grok、Cursorにサインインで接続し、画像・動画・音声を普通の言葉で頼めます。

  • ComfyUI

    ComfyUI向けMage

    Mango、Cherry、Seed Audioをはじめ、Mageのすべてのモデルを ComfyUIノードとして利用可能。GPUもモデルのダウンロードも不要です。

メディアの種類別

生成API

  • 18モデル

    AI画像生成API

    テキストから画像生成、編集、最大4Kの一貫したキャラクター生成に対応。

  • 15モデル

    AI動画生成API

    テキストから動画、画像から動画、フレーム指定、リファレンス、サウンドに対応。

  • 4モデル

    AI音声生成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回の呼び出し

すべてのモデルで、認証方式、非同期リクエストの流れ、フィールド名が共通です。

  1. APIキーを作成

    Mageにサインインし、API → APIキーを開いてキーを作成します。キーはmage_sk_で始まり、表示されるのは一度だけです。1つのアカウントで有効なキーは10個まで持てます。

  2. 生成をリクエスト

    Authorization: Bearerヘッダーを付けて、https://api.mage.space/v1/{model}/generateにJSONボディをPOSTします。レスポンスはすぐに返り、request_id、status、status_urlが含まれます。Idempotency-Keyヘッダーを送れば、リトライしても二重に支払うことはありません。

  3. ポーリングしてダウンロード

    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 のエージェントモードで、画像・動画・音声を生成できます。

モデル

注目のモデル

  • 画像 · 40 Gems から

    Flux 2 API

    長いプロンプトや複数参照での編集に対応

  • 画像 · 9 Gems から

    GPT Image 2 API

    的確なプロンプト反映と読みやすい文字

  • 画像 · 37 Gems から

    Guava API

    写真と見間違えるほどのフォトリアリズム

  • 画像 · 42 Gemsから

    Mango API

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

  • 画像 · 51 Gemsから

    Nano Banana 2 API

    くっきり読みやすい文字、最大 4K

  • 動画 · 618 Gems から

    Cherry API

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

  • 動画 · 245 Gems から

    Lemon API

    すべての動画機能を、よりお手頃な価格で

  • 動画 · 173 Gems から

    Plum API

    すべてのクリップに音声付き、最大 2K

  • 音声 · 19 Gems から

    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 APIは、https://api.mage.space/v1 のREST APIで、37種のモデルを使って自分のコードから画像・動画・音声を生成できます。リクエストは非同期で、生成ごとにGemsで支払います。
Mage MCP サーバーとは?
https://mcp.mage.space/mcp で提供されるリモートの Model Context Protocol サーバーで、AI アシスタントがあなたの Mage アカウントで画像・動画・音声を生成できるようになります。アシスタントは 16 個のツールを使って、モデルの選択、料金の見積もり、生成、結果の待機、保存済みのキャラクター・リファレンス・履歴の利用ができます。
MCP サーバーの利用に API キーは必要ですか?
いいえ。Claude、ChatGPT、Grok、Cursor、Claude Code は、OAuth で Mage にサインインして接続します。API キーは任意で、CI などのヘッドレス環境で使います。
Mage API の料金はいくらですか?
サブスクリプションや月額料金はありません。生成ごとに、モデルごとの表示価格が Gems で差し引かれます。標準パックでは 1,000 Gems が $1 です。各モデルのページにはデフォルト設定での価格が掲載されており、各レスポンスには実際の請求額が含まれます。生成に失敗した場合は返却されますが、Mage のコンテンツポリシーでブロックされた場合は返却されません。残高が足りないリクエストは、課金される前に拒否されます。
API を使うには Mage のメンバーシップが必要ですか?
いいえ。APIはGemのみで利用できます。メンバーシッププランとアプリ内での無制限生成は、APIリクエストには適用されません。まず、アカウントでGemパックまたはプランのいずれかを一度ご購入いただく必要があります。サインアップボーナスのGemはMageアプリでのみ使えます。
API で生成したものは商用利用できますか?
はい。APIやMCPサーバー経由を含め、Mageで作成したコンテンツは商用利用できます。クレジット表記は歓迎しますが、必須ではありません。
レート制限はどうなっていますか?
1アカウントで、待機中または実行中の生成は同時に20件までです。上限を超えた送信は429で拒否され、料金はかかりません。ご利用の用途に合わせて上限を引き上げたい場合は、[email protected] までご連絡ください。
AIエージェントからMage APIを使えますか?
はい。エージェントはキーを使ってREST APIを呼び出せるほか、Mage MCPサーバーにも接続できます。MCPサーバーでは、Claude、ChatGPT、Claude Code、Grok、Cursor向けに、モデルの選択、料金の見積もり、生成、結果の取得を行える16個のツールをすぐに使えます。詳しくはMCPサーバーをご覧ください。
Mage API用のSDKはありますか?
はい。npmの公式パッケージ @mage-space/sdk とPyPIのmage-spaceはオープンソースで、全モデルに対応した型を備えています。送信、結果の待機、安全な再試行、ファイルのアップロードをまとめて処理します。ComfyUIをお使いの方は、comfyui-mageノードパックをインストールできます。詳しくはMage SDKをご覧ください。
すでに別の生成APIを使っています。何を変更すればいいですか?
クライアントの接続先を https://api.mage.space/v1 に変更し、MageのキーをBearerトークンとして送信して、各項目をモデルページに合わせてください。prompt、aspect_ratio、resolution、duration、model_idは、どのMageモデルでも同じように使えます。リクエストは非同期なので、送信後にstatus_urlをポーリングしてください。

Mageで開発を始めよう

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

Charactersコミュニティ