Mage API · 画像モデル

Mango API

Mageの主力画像生成ファミリー

APIキーを取得プレイグラウンドでMangoを試す
POST https://api.mage.space/v1/mango/generate

ひと目でわかる概要

Mango APIは、POST https://api.mage.space/v1/mango/generate を通じて、Mage上でMango 3とその他4つのバージョンを実行します。デフォルト設定でのリクエストは135 Gem(約$0.135)で、サブスクは不要です。Mangoは、保存したキャラクターをプロンプト内の@handleで参照できます。

概要

Mango APIでできること

一貫したキャラクター、精密な編集、多数の参照画像やCharactersを組み合わせたシーンに強い画像生成ファミリーです。中心はMango 3で、Mango 3 Turboは最速・最安、Mango 3Sは3Kに対応します。

一貫したキャラクター、精密な編集、多数の参照画像を組み合わせたシーンに強い、Mageの主力画像生成ファミリーです。現行モデルはMango 3(`mango-v3`)で、Mango 3 Turbo(`mango-v3-turbo`)は最速・最安、Mango 3S(`mango-v3s`)は3Kに対応します。

入力として image、additional_images を受け付けます。

クイックスタート

Mango APIを呼び出す

MAGE_API_KEYを設定し、/mango/generate にリクエストを送信して、リクエストが完了するまで status_url をポーリングします。

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-v3"
}' | 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-v3',
});

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-v3",
})

print(request["result"]["url"])

モデル

Mangoのmodel_id値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

model_id名前デフォルト
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3はい
mango-v3-turboMango 3 Turbo

オプション

Mangoのパラメータ

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

フィールド値
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

入力

Mangoが受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

フィールド役割
image参照画像。
additional_images追加の参照画像。

その他の画像モデル

MageのほかのAI画像生成API

画像 · 68 Gems から

Nano Banana 2 API

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

画像 · 15 Gemsから

SDXL Plus API

顔と手を補正したSDXL

画像 · 10 Gems から

Stable Diffusion v1.5 API

低コストで使える定番モデル

画像 · 10 Gems から

Stable Diffusion v3.5 Large API

指示にいちばん忠実な Stable Diffusion

画像 · 10 Gems から

Stable Diffusion XL API

フォトリアル向けに調整されたSDXL

画像 · 10 Gems から

Z-Image API

Mageで最速の画像生成モデル

FAQ

よくある質問

Mango APIの料金はいくらですか?

デフォルト設定(Mango 3)でのMangoリクエストは135 Gem、約$0.135です。解像度、長さ、バージョンによって料金は変わり、正確な請求額はレスポンスに含まれます。生成に失敗した場合は返金されますが、Mageのコンテンツポリシーによりブロックされた場合は返金されません。

Mango APIのエンドポイントは?

MageのAPIキーを指定した Authorization: Bearer ヘッダーを付けて、POST https://api.mage.space/v1/mango/generate にリクエストします。レスポンスには、結果をポーリングするための status_url が含まれます。

どのMangoモデルを呼び出せますか?

mango(Mango)、mango-v2(Mango 2)、mango-v3s(Mango 3S)、mango-v3(Mango 3)、mango-v3-turbo(Mango 3 Turbo)です。デフォルトはMango 3です。

Mangoは参照画像やキャラクターに対応していますか?

Mangoは image、additional_images を受け付けます。保存したキャラクターは、プロンプト内の@handleで参照できます。

ClaudeやChatGPTからMangoを使えますか?

はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Mangoを名前で指定してください。アシスタントが get_model でオプションを確認し、生成前に料金を提示します。

Mangoの生成結果はどのくらい保存されますか?

生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

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

APIキーを取得プレイグラウンドでMangoを試す

関連情報