Mage API · SDK
Mage API 官方 SDK
提供 TypeScript 與 Python 的型別化用戶端,以及適用於 ComfyUI 的 Mage 節點。幾行程式碼就能使用所有圖片、影片與音訊模型。
重點速覽
Mage 為其 API 發布了開源 SDK:適用於 TypeScript 和 JavaScript 的 npm 套件 @mage-space/sdk、適用於 Python 的 PyPI 套件 mage-space,以及適用於 ComfyUI 的節點包 comfyui-mage。每個 SDK 都封裝了 REST API,提供涵蓋全部 37 款模型的型別化設定、自動輪詢、冪等重試和上傳功能。
- 3SDK 與整合
- 37型別化模型
- MIT開源
- $0安裝方式
選擇你的工具
SDK 與整合
npm install @mage-space/sdkTypeScript SDK
在 Node.js 中生成圖片、影片與音訊,每個 Mage 模型都有型別化設定。只需一次呼叫,就能送出請求、等待並取回結果。
pip install mage-spacePython SDK
在 Python 中生成圖片、影片與音訊,提供同步與 asyncio 用戶端,每個 Mage 模型都有型別化設定。
comfy node install comfyui-mage適用於 ComfyUI 的 Mage
Mango、Cherry、Seed Audio 和 Mage 的所有其他模型,都能作為 ComfyUI 節點使用。不需要 GPU,也不用下載模型。
快速開始
用 SDK 完成你的第一次生成
安裝套件、匯出 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"])內建功能
每個 SDK 都幫你處理好的事
一次呼叫,直接拿到成品
run 會送出生成請求,依 API 建議的退避間隔進行輪詢,最後回傳已完成的請求,並附上 result.url。
重試也不會重複扣款
每次送出都帶有冪等鍵。遇到網路錯誤與伺服器錯誤時會以退避方式重試,重試送出的請求絕不會再次收費。
一次呼叫完成上傳
太大而無法使用 data URL 的檔案會改走簽署上傳,票證、PUT 請求與大小檢查都由 SDK 代為處理。
清楚的錯誤訊息
API 拒絕請求時會附上 HTTP 狀態碼、錯誤代碼與請求 ID;生成失敗、被取消或逾時,也各有專屬的錯誤類型。
套件
取得方式
| SDK | 套件 | 安裝 | 原始碼 |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| Mage for ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
常見問題
常見問題
Mage SDK 是免費且開源的嗎?
新的 Mage 模型能搭配舊版 SDK 使用嗎?
SDK 如何避免重試請求時重複扣款?
SDK 穩定嗎?
Mage API 的費用是多少?
使用 API 需要 Mage 會員資格嗎?
API 生成的內容可以商用嗎?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。