あらゆるモデルが使えるAI画像生成API

ひと目でわかる概要

Mageの画像生成APIは、https://api.mage.space/v1 で提供されるREST APIで、Mango 3、Guava 2 Pro、GPT Image 2.5、Nano Banana 2、Flux 2、Krea 2など、15種類のテキストから画像を生成するモデルと画像編集モデルを実行できます。/{model}/generate にプロンプトをPOSTし、リクエストをポーリングして、画像をダウンロードします。料金は画像ごとにGemsで支払い、サブスクは不要です。

• 15

  画像モデル

• $0.009

  デフォルト設定での最安価格（1枚あたり）

• 20

  同時生成数

• $0

  月額料金

モデル

Mage APIのすべての画像モデル

料金は1回の生成ごとにGemsで表示しています。標準パックでは1,000 Gemsが$1で、大きいパックにはボーナスGemsが付きます。料金はモデル、解像度、長さによって変わります。ここにはデフォルト設定での料金を表示しており、実際の請求額は各レスポンスのbilling.gems_chargedで確認できます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。

クイックスタート

Anima v1で画像を生成

MAGE_API_KEYを設定してリクエストを送信し、完了するまでポーリングします。URL内のanimaは、上記の任意のモデルに置き換えられます。

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"

// 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);

# 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. 01

   APIキーを作成

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

2. 02

   生成をリクエスト

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

3. 03

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

   statusがcompleted、failed、cancelledのいずれかになるまで、status_urlをポーリングします。完了したリクエストには、画像・動画・音声ファイルを指すresult.urlが含まれ、ファイルは30日間保存されます。

本番運用向け

すべての Mage API リクエストで使える機能

ユースケース

開発者が画像APIで作っているもの

FAQ

よくある質問

Mageで開発を始めよう

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

関連情報

• AI動画生成API
• AI音声生成API
• Mage MCPサーバー
• Mage SDK
• Mage for ComfyUI
• すべてのAPIモデル
• APIプレイグラウンド
• APIドキュメント