一組金鑰,通用所有模型
28 個圖片、影片和音訊模型,整合在同一個 REST API 和同一份 Gems 餘額中。只要更改 URL 路徑,就能切換模型。
重點速覽
Mage 為開發者提供位於 https://api.mage.space/v1 的 REST API,以及位於 https://mcp.mage.space/mcp 的遠端 MCP 伺服器。兩者都能在同一個帳號下使用相同的 28 個圖片、影片與音訊生成模型,包括 Mage 獨家的 Mango 3 和 Cherry 2 Pro,每次生成都以 Gems 付費,無需訂閱。
28
模型
3
媒體類型
16
MCP 工具
$0
月費
使用方式
用程式碼、AI 助理或 ComfyUI 呼叫
REST API
Mage API
用金鑰從你自己的程式碼提交生成請求。支援非同步請求、冪等重試、最大 100 MB 的上傳,以及同時進行 20 個生成。
SDK
TypeScript 和 Python SDK
官方提供的型別化用戶端,只要幾行程式碼就能提交請求、等待結果、安全重試並上傳檔案。
MCP 伺服器
Mage MCP 伺服器
登入後即可連接 Claude、ChatGPT、Claude Code、Grok 或 Cursor,用日常的說話方式就能要求生成圖片、影片和音訊。
ComfyUI
適用於 ComfyUI 的 Mage
Mango、Cherry、Seed Audio 和 Mage 的所有其他模型,都能作為 ComfyUI 節點使用。不需要 GPU,也不用下載模型。
依媒體類型
生成 API
快速開始
你的第一次生成
在 API → API Keys 建立金鑰,將它匯出為 MAGE_API_KEY,然後執行下列任一範例。
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"])運作方式
從 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 天。
MCP
在 AI 助理中使用 Mage
模型
精選模型
圖片 · 每次 40 Gems 起
Flux 2 API
支援長提示詞與多重參考編輯
圖片 · 每次 9 Gems 起
GPT Image 2 API
精準遵循提示詞,文字清晰易讀
圖片 · 每次 37 Gems 起
Guava API
擬真度媲美實拍照片
圖片 · 每次 135 Gems 起
Mango API
我們的旗艦圖片系列
圖片 · 每次 68 Gems 起
Nano Banana 2 API
文字銳利清晰,最高支援 4K
影片 · 每次 618 Gems 起
Cherry API
我們的旗艦影片系列
影片 · 每次 245 Gems 起
Lemon API
完整影片功能,價格更親民
影片 · 每次 338 Gems 起
Plum API
每個片段都有聲音,最高支援 2K
音訊 · 每次 19 Gems 起
Seed Audio API
一個提示詞,生成人聲、音樂和音效
為正式上線打造
每個 Mage API 請求都享有的功能
依生成次數計費
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
安全重試
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
角色保持一致
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
支援大型輸入檔案
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
同時處理 20 個生成任務
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
常見問題
常見問題
什麼是 Mage API?
Mage API 是位於 https://api.mage.space/v1 的 REST API,讓你直接用自己的程式碼,透過 28 個模型生成圖片、影片和音訊。請求採非同步處理,並依每次生成以 Gems 計費。
什麼是 Mage MCP 伺服器?
這是位於 https://mcp.mage.space/mcp 的遠端 Model Context Protocol 伺服器,可讓 AI 助理使用你的 Mage 帳號生成圖片、影片和音訊。它提供 16 種工具,讓助理選擇模型、報價、生成、等待結果,並使用你儲存的角色、參考素材和歷史紀錄。
使用 MCP 伺服器需要 API 金鑰嗎?
不需要。Claude、ChatGPT、Grok、Cursor 和 Claude Code 都是透過 OAuth 登入 Mage 來連線。API 金鑰為選用,適用於 CI 等無介面環境。
Mage API 的費用是多少?
沒有訂閱制,也沒有月費。每次生成都依該模型的標示價格以 Gems 支付,標準方案中 1,000 Gems 為 $1。每個模型頁面都會列出預設設定下的價格,每次回應也會顯示實際扣款金額。生成失敗會退款;但被 Mage 內容政策封鎖的不會退款。若你的餘額不足以支付請求,系統會在扣款前直接拒絕。
使用 API 需要 Mage 會員資格嗎?
不需要。API 只使用 Gems。會員方案及其應用程式內無限生成的權益不適用於 API 請求,因此任何擁有 Gems 的 Mage 帳號都能呼叫。
API 生成的內容可以商用嗎?
可以。你使用 Mage 建立的內容,包括透過 API 和 MCP 伺服器產生的內容,都可以用於商業用途。我們歡迎標示出處,但不強制要求。
速率限制是多少?
每個帳號最多可同時有 20 個生成任務排隊或執行中。超過上限的送出請求會被以 429 拒絕,且不會收費。如果你的使用情境需要更高的上限,請寫信到 [email protected]。
我的 AI Agent 可以使用 Mage API 嗎?
可以。Agent 可以使用金鑰呼叫 REST API,也可以連接 Mage MCP 伺服器,為 Claude、ChatGPT、Claude Code、Grok 和 Cursor 提供十六個現成工具,用來選擇模型、查詢價格、生成內容及取得結果。請參閱MCP 伺服器。
Mage API 有提供 SDK 嗎?
有。npm 上的官方 @mage-space/sdk 套件與 PyPI 上的 mage-space 皆為開源,並為每個模型提供型別定義。它們會幫你送出請求、等待結果、安全地重試,並上傳檔案。ComfyUI 使用者可以安裝 comfyui-mage 節點包。請參閱Mage SDK。
我已經在用其他生成 API,需要更改哪些地方?
將你的用戶端指向 https://api.mage.space/v1,以 Bearer token 的方式傳送你的 Mage 金鑰,並依照模型頁面對應你的欄位:prompt、aspect_ratio、resolution、duration 和 model_id 在所有 Mage 模型中的用法都相同。請求為非同步,因此請先送出,再輪詢 status_url。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。