Mage API · 音訊生成
生成人聲、音樂與音效的 AI 音訊生成 API
用 Seed Audio 從一則提示生成語音、旁白、音樂與音效,並支援聲音參考,以及語速、音量和音高控制。
POST https://api.mage.space/v1/{model}/generate重點速覽
Mage 音訊生成 API 透過 https://api.mage.space/v1/seed_audio/generate 執行 Seed Audio。傳送文字提示(可附上聲音參考或圖片),就能取得最長 120 秒、包含人聲、音樂或音效的音訊檔。每個片段以 Gems 付費,無需訂閱。
- 4音訊模型
- $0.019預設最低價,每支影片
- 20同時生成數
- $0月費
模型
Mage API 的所有音訊模型
價格以每次生成計算,單位為 Gems。標準包 1,000 Gems 為 $1,較大的方案包會加贈 Gems。價格取決於模型、解析度和時長;此處顯示的是預設設定下的價格,每個回應都會在 billing.gems_charged 中回報實際扣款。生成失敗會退款;被 Mage 內容政策封鎖的則不會退款。
| 模型 | 最適合 | 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) |
快速開始
用 Eleven Music v2.5 生成音訊
設定 MAGE_API_KEY、送出請求,然後輪詢直到完成。你也可以把 URL 中的 eleven_music 換成上方任一模型。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
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 天。
為正式上線打造
每個 Mage API 請求都享有的功能
一組金鑰,通用所有模型
37 款圖片、影片與音訊模型,共用一組 REST API 和一個 Gems 餘額。只要更改 URL 路徑即可切換模型。
依生成次數計費
無需訂閱,也沒有最低消費。你只要購買 Gems,每次請求就會依標示價格扣款。生成失敗會退還 Gems,但因違反 Mage 內容政策而被封鎖的除外。
安全重試
透過冪等鍵,重新送出的請求會回傳原本的結果,不會重複扣款。
角色保持一致
只要儲存一次角色或參考素材,之後在任何提示詞中輸入 @handle,就能搭配所有支援的模型使用。
支援大型輸入檔案
可用 URL 或 data URL 傳送圖片、影片和音訊,也可透過簽署上傳功能上傳最大 100 MB 的檔案。
同時處理 20 個生成任務
每個帳號可同時執行 20 個生成任務,也可以依你的使用情境調高上限。被拒絕的請求一律不會扣款。
使用情境
開發者用音訊 API 打造什麼
旁白與配音
為影片、解說內容和有聲書生成旁白,並可控制語速、音量和音高。
一致的聲音
將聲音片段儲存為參考,再用 @handle 提及它,就能在不同片段中維持相同的聲音。
音效
用文字描述為遊戲和應用程式創造環境音、擬音和介面音效。
背景音樂
用提示為社群短片和廣告製作背景音樂。
為生成影片配上配樂
搭配影片 API 使用 Seed Audio,為無聲模型產生的影片加上聲音。
會說話的 Agent
讓 Claude、ChatGPT 或你自己的 Agent 透過 MCP 伺服器或 REST API 產生音訊。
常見問題
常見問題
音訊 API 可以做文字轉語音嗎?
生成的音訊最長可以多長?
Mage API 的費用是多少?
使用 API 需要 Mage 會員資格嗎?
API 生成的內容可以商用嗎?
速率限制是多少?
我的 AI Agent 可以使用 Mage API 嗎?
Mage API 有提供 SDK 嗎?
我已經在用其他生成 API,需要更改哪些地方?
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。