Mage API · 圖片生成
支援所有模型的 AI 圖片生成 API
透過一組金鑰和一份餘額,使用 18 款模型(包括 Mage 旗艦模型 Mango 4)進行文字生成圖片、圖片編輯與一致角色生成。
POST https://api.mage.space/v1/{model}/generate重點速覽
Mage 圖片生成 API 是位於 https://api.mage.space/v1 的 REST API,可執行 18 款文字生成圖片與圖片編輯模型,包括 Mango 4、Guava 2 Pro、GPT Image 2.6、Nano Banana 2、Flux 2 和 Krea 2。你只需將提示詞 POST 到 /{model}/generate,輪詢請求狀態,再下載圖片。每張圖片以 Gems 付費,無需訂閱。
- 18種圖片模型
- $0.009每張最低預設價格
- 20同時生成數
- $0月費
模型
Mage API 中的所有圖片模型
價格以每次生成計算,單位為 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 提供兩種等級 | 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 | 我們的旗艦圖片系列 | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | 原生 1,600 萬像素圖片,開放權重 | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | 支援長提示詞與雙語文字,開放權重 | 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,送出請求,然後輪詢直到完成。把網址中的 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 金鑰到成品,只需三次呼叫
所有模型都使用同一套驗證機制、同一個非同步請求流程和相同的欄位名稱。
建立 API 金鑰
登入 Mage,開啟 API → API Keys 並建立金鑰。金鑰以 mage_sk_ 開頭,只會顯示一次。每個帳號最多可有 10 組啟用中的金鑰。
提交生成請求
以 POST 方式將 JSON 內容傳送到 https://api.mage.space/v1/{model}/generate,並帶上 Authorization: Bearer 標頭。回應會立即傳回 request_id、status 和 status_url。請附上 Idempotency-Key 標頭,重試時就不會重複扣款。
輪詢並下載
持續輪詢 status_url,直到狀態變成 completed、failed 或 cancelled。已完成的請求會包含 result.url,指向圖片、影片或音訊檔案,檔案會保存 30 天。
為正式上線打造
每個 Mage API 請求都享有的功能
一組金鑰,通用所有模型
37 款圖片、影片與音訊模型,共用一組 REST API 和一個 Gems 餘額。只要更改 URL 路徑即可切換模型。
依生成次數計費
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
安全重試
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
角色保持一致
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
支援大型輸入檔案
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
同時處理 20 個生成任務
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
使用情境
開發者用圖片 API 打造什麼
產品與行銷圖片
隨時產出商品圖、廣告版本和社群貼文,並藉由 GPT Image 2.6 或 Nano Banana 2 生成清晰可讀的文字。
角色保持一致
只要儲存一次角色,就能用 Mango 4、Guava 2 Pro 和其他支援 @handle 提及的模型,讓整組圖片都維持同一張臉。
圖片編輯流程
傳入來源圖片與指令,只修改你指定的內容,其餘部分維持不變。
應用程式與遊戲
直接在你的產品中生成頭像、貼圖、卡片與場景,完全不用自己架設 GPU。
擬真人像
Guava 2 Pro 能生成人像、時尚與生活風格照片,肌膚、布料與光線都栩栩如生。
大量快速草稿
Z-Image Turbo 與 Krea 2 價格親民,適合大量縮圖與初稿製作。
常見問題
常見問題
最好的 AI 圖片生成 API 是哪一個?
圖片 API 支援圖片編輯與參考圖片嗎?
圖片 API 支援哪些解析度?
Mage API 的費用是多少?
使用 API 需要 Mage 會員資格嗎?
API 生成的內容可以商用嗎?
速率限制是多少?
我的 AI Agent 可以使用 Mage API 嗎?
Mage API 有提供 SDK 嗎?
我已經在用其他生成 API,需要更改哪些地方?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。