一組金鑰,通用所有模型
28 個圖片、影片和音訊模型,整合在同一個 REST API 和同一份 Gems 餘額中。只要更改 URL 路徑,就能切換模型。
重點速覽
Mage 圖片生成 API 是位於 https://api.mage.space/v1 的 REST API,可執行 15 種文字生圖與圖片編輯模型,包括 Mango 3、Guava 2 Pro、GPT Image 2.5、Nano Banana 2、Flux 2 和 Krea 2。你只要將提示詞 POST 到 /{model}/generate,輪詢請求狀態,再下載圖片即可。每張圖片以 Gems 付費,無需訂閱。
15
種圖片模型
$0.009
每張最低預設價格
20
同時生成數
$0
月費
模型
價格以每次生成計算,單位為 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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine,提供三種品質等級 | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | 清晰可讀的文字,最高 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | 修正了臉部與手部的 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
快速開始
設定 MAGE_API_KEY,送出請求,然後輪詢直到完成。把網址中的 anima 換成上方任一模型即可。
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"// 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);# 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"])運作方式
所有模型都使用同一套驗證機制、同一個非同步請求流程和相同的欄位名稱。
登入 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 天。
為正式上線打造
28 個圖片、影片和音訊模型,整合在同一個 REST API 和同一份 Gems 餘額中。只要更改 URL 路徑,就能切換模型。
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
使用情境
隨需產出產品照、廣告變體和社群貼文,並透過 GPT Image 2.5 或 Nano Banana 2 取得清晰可讀的文字。
只要儲存一次角色,就能在整組圖片中維持同一張臉,支援 Mango 3、Guava 2 Pro 及其他可使用 @handle 提及的模型。
傳入來源圖片與指令,只修改你指定的內容,其餘部分維持不變。
直接在你的產品中生成頭像、貼圖、卡片與場景,完全不用自己架設 GPU。
Guava 2 Pro 能生成人像、時尚與生活風格照片,肌膚、布料與光線都栩栩如生。
Z-Image Turbo 與 Krea 2 價格親民,適合大量縮圖與初稿製作。
常見問題
要看用途。在 Mage 上,Mango 3 是多數圖片的預設選擇:能精準遵循指令、維持角色一致,編輯時也不會動到圖片的其他部分。Guava 2 Pro 最適合擬真風格,GPT Image 2.5 與 Nano Banana 2 擅長圖片中的文字,Z-Image Turbo 或 Krea 2 則適合快速、低成本的草稿。這些模型都使用同一個 API。
支援。可接受圖片的模型,可透過 image 與 additional_images 欄位傳入圖片,格式可以是網址、data URL 或上傳檔案。每個模型頁面都列出了支援的輸入內容,以及可使用幾張參考圖片。
依模型而定:多數模型支援 1K 與 2K,Mango 3S 支援 3K,Mango 2 與 Nano Banana 2 最高可達 4K。每個模型頁面都列出了可用的解析度與長寬比選項。
沒有訂閱制,也沒有月費。每次生成都依該模型的標示價格以 Gems 支付,標準方案中 1,000 Gems 為 $1。每個模型頁面都會列出預設設定下的價格,每次回應也會顯示實際扣款金額。生成失敗會退款;但被 Mage 內容政策封鎖的不會退款。若你的餘額不足以支付請求,系統會在扣款前直接拒絕。
不需要。API 只使用 Gems。會員方案及其應用程式內無限生成的權益不適用於 API 請求,因此任何擁有 Gems 的 Mage 帳號都能呼叫。
可以。你使用 Mage 建立的內容,包括透過 API 和 MCP 伺服器產生的內容,都可以用於商業用途。我們歡迎標示出處,但不強制要求。
每個帳號最多可同時有 20 個生成任務排隊或執行中。超過上限的送出請求會被以 429 拒絕,且不會收費。如果你的使用情境需要更高的上限,請寫信到 [email protected]。
可以。Agent 可以使用金鑰呼叫 REST API,也可以連接 Mage MCP 伺服器,為 Claude、ChatGPT、Claude Code、Grok 和 Cursor 提供十六個現成工具,用來選擇模型、查詢價格、生成內容及取得結果。請參閱MCP 伺服器。
有。npm 上的官方 @mage-space/sdk 套件與 PyPI 上的 mage-space 皆為開源,並為每個模型提供型別定義。它們會幫你送出請求、等待結果、安全地重試,並上傳檔案。ComfyUI 使用者可以安裝 comfyui-mage 節點包。請參閱Mage SDK。
將你的用戶端指向 https://api.mage.space/v1,以 Bearer token 的方式傳送你的 Mage 金鑰,並依照模型頁面對應你的欄位:prompt、aspect_ratio、resolution、duration 和 model_id 在所有 Mage 模型中的用法都相同。請求為非同步,因此請先送出,再輪詢 status_url。
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。