Mage API · 為你的下一個靈感而生
一個 API,無限可能。
把 Mage 的強大功能帶進你的產品和 AI 助理。只需一組 API 金鑰或一個 MCP 連線,就能生成圖片、影片和音訊。
https://api.mage.space/v1重點速覽
Mage 為開發者提供位於 https://api.mage.space/v1 的 REST API,以及位於 https://mcp.mage.space/mcp 的遠端 MCP 伺服器。兩者在同一個帳號下執行相同的 37 款圖片、影片與音訊模型,包括 Mage 獨家的 Mango 4 和 Cherry 2 Pro,每次生成都以 Gems 付費,無需訂閱。
- 37模型
- 3媒體類型
- 16MCP 工具
- $0月費
使用方式
用程式碼、AI 助理或 ComfyUI 呼叫
Mage API
用金鑰從你自己的程式碼提交生成請求。支援非同步請求、冪等重試、最大 100 MB 的上傳,以及同時進行 20 個生成。
TypeScript 和 Python SDK
官方提供的型別化用戶端,只要幾行程式碼就能提交請求、等待結果、安全重試並上傳檔案。
Mage MCP 伺服器
登入後即可連接 Claude、ChatGPT、Claude Code、Grok 或 Cursor,用日常的說話方式就能要求生成圖片、影片和音訊。
適用於 ComfyUI 的 Mage
Mango、Cherry、Seed Audio 和 Mage 的所有其他模型,都能作為 ComfyUI 節點使用。不需要 GPU,也不用下載模型。
依媒體類型
生成 API
AI 圖片生成 API
文字生圖、圖片編輯,以及最高 4K 的一致角色。
AI 影片生成 API
文字生成影片、圖片生成影片、影格、參考素材與聲音。
AI 音訊生成 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-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"])運作方式
從 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
在 Claude 中使用 Mage
在 Claude 網頁版、桌面應用程式、行動應用程式和 Cowork 中生成圖片、影片與音訊。
在 ChatGPT 中使用 Mage
以個人 MCP 應用程式的方式,在 ChatGPT 中生成圖片、影片與音訊。
Claude Code 中的 Mage
在終端機和編輯器的 Claude Code 中生成圖片、影片和音訊。
Grok 中的 Mage
透過自訂連接器,在 Grok 中生成圖片、影片和音訊。
Cursor 中的 Mage
在 Cursor 的 Agent 模式中生成圖片、影片和音訊。
模型
精選模型
Flux 2 API
支援長提示詞與多重參考編輯
GPT Image 2 API
精準遵循提示詞,文字清晰易讀
Guava API
擬真度媲美實拍照片
Mango API
我們的旗艦圖片系列
Nano Banana 2 API
文字銳利清晰,最高支援 4K
Cherry API
我們的旗艦影片系列
Lemon API
完整影片功能,價格更親民
Plum API
每個片段都有聲音,最高支援 2K
Seed Audio API
一個提示詞,生成人聲、音樂和音效
為正式上線打造
每個 Mage API 請求都享有的功能
一組金鑰,通用所有模型
37 款圖片、影片與音訊模型,共用一組 REST API 和一個 Gems 餘額。只要更改 URL 路徑即可切換模型。
依生成次數計費
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
安全重試
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
角色保持一致
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
支援大型輸入檔案
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
同時處理 20 個生成任務
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
常見問題
常見問題
什麼是 Mage API?
什麼是 Mage MCP 伺服器?
使用 MCP 伺服器需要 API 金鑰嗎?
Mage API 的費用是多少?
使用 API 需要 Mage 會員資格嗎?
API 生成的內容可以商用嗎?
速率限制是多少?
我的 AI Agent 可以使用 Mage API 嗎?
Mage API 有提供 SDK 嗎?
我已經在用其他生成 API,需要更改哪些地方?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。