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

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-v120 Gems ($0.02)
ChromaFluxベースのオープンウェイトモデルchroma-v1-hd35 Gems ($0.035)
Flux 2長いプロンプトや複数参照での編集にflux2-dev40 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-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine、2つのティアgrok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
Guava写真と見紛うフォトリアリズムguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDream高速で万能、ネガティブプロンプトにも対応hidream-fast20 Gems ($0.02)
Krea 2数秒で美しい仕上がりkrea-2-turbo20 Gems ($0.02)
MangoMageのフラッグシップ画像ファミリーmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 Imageネイティブ1600万画素の画像、オープンウェイトminimax-h3-image15 Gems ($0.015)
MOSS-Image長いプロンプトと2言語のテキストに対応、オープンウェイトmoss-image25 Gems ($0.025)
Nano Banana 2くっきり読めるテキスト、最大4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL Plus顔と手を改善したSDXL6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream(厳格なフィルター付き)seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5定番モデルを低価格で15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 Large指示に最もよく従うStable Diffusionsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLフォトリアル向けに調整したSDXL6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageMageで最速の画像モデルz-image-turbo10 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回の呼び出し

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

  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日間保存されます。

本番運用向け

すべての 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は?
用途によって異なります。Mageでは、ほとんどの画像にMango 4がデフォルトです。細かな指示に従い、キャラクターの一貫性を保ち、画像の他の部分を崩さずに編集できます。フォトリアルならGuava 2 Pro、画像内のテキストならGPT Image 2.6とNano Banana 2、低コストで素早い下書きならZ-Image TurboやKrea 2がおすすめです。どれも同じAPIで実行できます。
画像APIは画像編集と参照画像に対応していますか?
はい。画像を受け付けるモデルでは、imageとadditional_imagesフィールドにURL、データURL、アップロードで画像を渡せます。各モデルのページに、入力内容と参照画像の上限枚数が記載されています。
画像APIはどの解像度に対応していますか?
モデルによって異なります。ほとんどのモデルは1Kと2K、Mango 3Sは3K、Mango 2とNano Banana 2は最大4Kに対応しています。各モデルのページに、解像度とアスペクト比の選択肢が記載されています。
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コミュニティ