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

Mage API · 画像モデル

Mango API

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

POST https://api.mage.space/v1/mango/generate

ひと目でわかる概要

Mango APIでは、POST https://api.mage.space/v1/mango/generate を通じて、Mage上でMango 4とその他5つのバリアントを実行できます。デフォルト設定のリクエストは42 Gems(約$0.042)で、サブスクリプションは不要です。Mangoでは、保存済みのCharactersや、プロンプト内で@handleを指定したReferencesを利用できます。

  • 画像出力
  • 6バリアント
  • 421枚あたりのGems(デフォルト)
  • $0.042米ドル換算の目安

概要

Mango APIでできること

キャラクターの一貫性、精密な編集、そして複数のリファレンスやCharactersを組み合わせたシーン作りに向いた画像生成AIファミリーです。ファミリーの中心はMango 4で、最もリアルな光と肌の表現、そして最も鮮明な小さい文字を実現。Mango 3 Turboはリファレンスを含めて定額でラフ案を作成でき、Mango 3Sは3Kに対応します。

Mageの主力画像生成AIファミリーで、キャラクターの一貫性、精密な編集、複数のリファレンスを組み合わせたシーン作りに向いています。Mango 4(`mango-v4`)は最新のデフォルトモデルで、最もリアルな光と肌の表現、最も鮮明な小さい文字が特長です。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-v4"
}' | 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-v4',
});

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

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-v4Mango 4はい

オプション

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

  • 画像 · 15 Gemsから

    MiniMax H3 Image API

    ネイティブ1600万画素の画像、オープンウェイト

  • 画像 · 25 Gemから

    MOSS-Image API

    長いプロンプトと2言語のテキストに対応、オープンウェイト

  • 画像 · 51 Gemsから

    Nano Banana 2 API

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

  • 画像 · 15 Gemsから

    SDXL Plus API

    顔と手を補正したSDXL

  • 画像 · 42 Gemsから

    Seedream API

    Seedream(厳格なフィルター付き)

  • 画像 · 10 Gems から

    Stable Diffusion v1.5 API

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

FAQ

よくある質問

Mango APIの料金はいくらですか?
デフォルト設定(Mango 4)でのMangoリクエストは42 Gems、約$0.042です。解像度、長さ、バリアントを変更すると料金も変わります。正確な請求額はレスポンスで確認できます。生成に失敗した場合は返金されますが、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-v4(Mango 4)。デフォルトはMango 4です。
Mangoは参照画像やキャラクターに対応していますか?
Mangoは image、additional_images を受け付けます。保存したキャラクターは、プロンプト内の@handleで参照できます。
ClaudeやChatGPTからMangoを使えますか?
はい。Mage MCPサーバーをClaude、ChatGPT、Claude Code、Grok、Cursorに接続し、Mangoを名前で指定してください。アシスタントが get_model でオプションを確認し、生成前に料金を提示します。
Mangoの生成結果はどのくらい保存されますか?
生成結果と入力データは30日間保存されます。残したいものは自分のストレージにダウンロードしてください。

Mageで開発を始めよう

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

Charactersコミュニティ