ひと目でわかる概要
Mage APIでは、https://api.mage.space/v1/{model}/generate で画像モデル15個、動画モデル12個、音声モデル1個を実行できます。すべてのモデルで同じキー、リクエストの流れ、フィールド名を使え、料金は生成ごとにGemsで支払います。
15
画像モデル
12
動画モデル
1
音声モデル
1
すべてに使えるAPIキー
画像モデル
画像生成モデル
料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。
| モデル | おすすめの用途 | model_idの値 | デフォルト価格 |
|---|---|---|---|
| Anima | アニメ専用に設計 | anima-v1 | 20 Gems ($0.02) |
| Chroma | Fluxベースのオープンウェイトモデル | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | 長いプロンプトや複数参照での編集に | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | 正確なプロンプト再現と読みやすいテキスト | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine(3つの品質ティア) | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | 写真と見紛うフォトリアリズム | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | 高速で万能、ネガティブプロンプトにも対応 | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | 数秒で美しい仕上がり | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Mageのフラッグシップ画像ファミリー | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | くっきり読めるテキスト、最大4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | 顔と手を改善したSDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | 定番モデルを低価格で | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | 指示に最もよく従うStable Diffusion | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | フォトリアル向けに調整したSDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mageで最速の画像モデル | z-image-turbo | 10 Gems ($0.01) |
動画モデル
動画生成モデル
| モデル | おすすめの用途 | 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-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) |
| Melon | 動くアニメ、音声も追加可能 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | ステレオサウンド付きの高速オープン動画 | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | すべてのクリップに音声付き、最大2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | 最初のフレームからキャラクターに命を吹き込む | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Lightningバリアントを備えたオープンウェイト動画 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
音声モデル
音声生成モデル
| モデル | おすすめの用途 | model_idの値 | デフォルト価格 |
|---|---|---|---|
| Seed Audio | ひとつのプロンプトからボイス、音楽、効果音を生成 | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
よくある質問
Mage API の料金はいくらですか?
サブスクリプションや月額料金はありません。生成ごとに、モデルごとの表示価格が Gems で差し引かれます。標準パックでは 1,000 Gems が $1 です。各モデルのページにはデフォルト設定での価格が掲載されており、各レスポンスには実際の請求額が含まれます。生成に失敗した場合は返却されますが、Mage のコンテンツポリシーでブロックされた場合は返却されません。残高が足りないリクエストは、課金される前に拒否されます。
API を使うには Mage のメンバーシップが必要ですか?
いいえ。API は Gems だけで利用できます。メンバーシッププランやアプリ内での無制限生成は API リクエストには適用されないため、Gems のある 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の残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。