Mage API · 模型
37 款生成模型,一個 API
Mage API 提供的所有圖片、影片和音訊模型,包含各自最擅長的用途、model_id 值,以及預設設定下的價格。
POST https://api.mage.space/v1/{model}/generate重點速覽
Mage API 在 https://api.mage.space/v1/{model}/generate 提供 18 款圖片模型、15 款影片模型和 4 款音訊模型。所有模型都使用相同的金鑰、請求流程和欄位名稱,並依每次生成以 Gems 計費。
- 18圖片模型
- 15影片模型
- 4音訊模型
- 1組 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) |
影片模型
影片生成模型
| 模型 | 最適合 | model_id 值 | 預設價格 |
|---|---|---|---|
| Berry | 忠實呈現你參考素材的影片 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 鎖定首尾影格 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | 我們的旗艦影片系列 | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 動起來的 Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 日常影片,免設定 | kiwi | 270 Gems ($0.27) |
| Lemon | 完整影片功能,價格更親民 | lemon | 245 Gems ($0.245) |
| LTX Video | 適合反覆調整的快速開放權重影片模型 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | 重新演繹任何影片,並保留原有動態 | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | 動態動漫,可選配音訊 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | 快速開放式影片,支援立體聲 | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | 每支影片都有聲音,最高 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | 從首張影格讓角色活起來 | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance,內容過濾較為嚴格 | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0,內容過濾嚴格 | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | 開放權重影片模型,提供 Lightning 版本 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
音訊模型
音訊生成模型
| 模型 | 最適合 | model_id 值 | 預設價格 |
|---|---|---|---|
| Eleven Music | ElevenLabs 歌曲生成,有人聲或純音樂皆可 | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4:可自由掌控的擬真語音 | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | 依你的歌詞生成完整歌曲,開放權重 | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | 一則提示就能生成人聲、音樂與音效 | seed-audio-1.0 | 19 Gems ($0.019) |
常見問題
常見問題
Mage API 的費用是多少?
沒有訂閱制,也沒有月費。每次生成都依該模型的標示價格以 Gems 支付,標準方案中 1,000 Gems 為 $1。每個模型頁面都會列出預設設定下的價格,每次回應也會顯示實際扣款金額。生成失敗會退款;但被 Mage 內容政策封鎖的不會退款。若你的餘額不足以支付請求,系統會在扣款前直接拒絕。
使用 API 需要 Mage 會員資格嗎?
不行。API 只能使用 Gems。會員方案及其應用程式內的無限生成,並不適用於 API 請求。帳號需要先完成一次成功付款,購買任一 Gem 包或訂閱任一方案皆可;註冊贈送的 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 餘額,通用所有模型。只需為你生成的內容付費。