Mage API · 画像生成
あらゆるモデルが使えるAI画像生成API
Mageのフラッグシップ Mango 4 を含む18モデルによる、テキストから画像生成、画像編集、一貫したキャラクター生成を、1つのキーと1つの残高で。
POST https://api.mage.space/v1/{model}/generateひと目でわかる概要
Mageの画像生成APIは、Mango 4、Guava 2 Pro、GPT Image 2.6、Nano Banana 2、Flux 2、Krea 2を含む18種類のテキストから画像生成・画像編集モデルを実行できる、https://api.mage.space/v1 のREST APIです。/{model}/generate にプロンプトをPOSTし、リクエストをポーリングして、画像をダウンロードします。画像ごとにGemsで支払い、サブスクリプションは不要です。
- 18画像モデル
- $0.009デフォルト設定での最安価格(1枚あたり)
- 20同時生成数
- $0月額料金
モデル
Mage 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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine、2つのティア | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | ネイティブ1600万画素の画像、オープンウェイト | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | 長いプロンプトと2言語のテキストに対応、オープンウェイト | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | くっきり読めるテキスト、最大4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | 顔と手を改善したSDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream(厳格なフィルター付き) | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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) |
クイックスタート
Anima v1で画像を生成
MAGE_API_KEYを設定してリクエストを送信し、完了するまでポーリングします。URL内のanimaは、上記の任意のモデルに置き換えられます。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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 投稿用の画像を必要なときにすぐ生成。GPT Image 2.6 や Nano Banana 2 なら、文字もくっきり読みやすく描けます。
一貫したキャラクター
キャラクターを一度保存すれば、Mango 4、Guava 2 Pro、そして @handle メンションに対応する他のモデルで、セット全体を通して同じ顔を保てます。
画像編集パイプライン
元の画像と指示を送るだけで、指定した部分だけを変更し、それ以外はそのまま保てます。
アプリとゲーム
GPUを自前で用意しなくても、アバター、ステッカー、カード、シーンをプロダクト内で生成できます。
フォトリアルなポートレート
Guava 2 Proは、肌、布地、光をリアルに再現し、ポートレート、ファッション、ライフスタイルの写真を生成します。
大量の下書きを高速に
Z-Image TurboとKrea 2なら、大量のサムネイルや初稿も低価格で生成できます。
FAQ
よくある質問
最適なAI画像生成APIは?
画像APIは画像編集と参照画像に対応していますか?
画像APIはどの解像度に対応していますか?
Mage API の料金はいくらですか?
API を使うには Mage のメンバーシップが必要ですか?
API で生成したものは商用利用できますか?
レート制限はどうなっていますか?
AIエージェントからMage APIを使えますか?
Mage API用のSDKはありますか?
すでに別の生成APIを使っています。何を変更すればいいですか?
Mageで開発を始めよう
アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。