Mage API · 音訊生成

生成人聲、音樂與音效的 AI 音訊生成 API

用 Seed Audio 從一則提示生成語音、旁白、音樂與音效,並支援聲音參考,以及語速、音量和音高控制。

取得 API 金鑰閱讀 API 文件
POST https://api.mage.space/v1/{model}/generate

重點速覽

Mage 音訊生成 API 透過 https://api.mage.space/v1/seed_audio/generate 執行 Seed Audio。傳送文字提示(可附上聲音參考或圖片),就能取得最長 120 秒、包含人聲、音樂或音效的音訊檔。每個片段以 Gems 付費,無需訂閱。

模型

Mage API 的所有音訊模型

價格以每次生成計算,單位為 Gems。標準包 1,000 Gems 為 $1,較大的方案包會加贈 Gems。價格取決於模型、解析度和時長;此處顯示的是預設設定下的價格,每個回應都會在 billing.gems_charged 中回報實際扣款。生成失敗會退款;被 Mage 內容政策封鎖的則不會退款。

模型最適合model_id 值預設價格
Seed Audio一則提示就能生成人聲、音樂與音效seed-audio-1.019 Gems ($0.019)

快速開始

用 Seed Audio 生成音訊

設定 MAGE_API_KEY,送出請求,然後輪詢直到完成。把網址中的 seed_audio 換成上方任一模型即可。

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A calm narrator reading a short weather report",
  "duration": "5",
  "model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seed_audio", {
    "prompt": "A calm narrator reading a short weather report",
    "duration": "5",
    "model_id": "seed-audio-1.0",
})

print(request["result"]["url"])

運作方式

從 API 金鑰到成品,只需三次呼叫

所有模型都使用同一套驗證機制、同一個非同步請求流程和相同的欄位名稱。

  1. 建立 API 金鑰

    登入 Mage,開啟 API → API Keys 並建立金鑰。金鑰以 mage_sk_ 開頭,只會顯示一次。每個帳號最多可有 10 組啟用中的金鑰。

  2. 提交生成請求

    以 POST 方式將 JSON 內容傳送到 https://api.mage.space/v1/{model}/generate,並帶上 Authorization: Bearer 標頭。回應會立即傳回 request_id、status 和 status_url。請附上 Idempotency-Key 標頭,重試時就不會重複扣款。

  3. 輪詢並下載

    持續輪詢 status_url,直到狀態變成 completed、failed 或 cancelled。已完成的請求會包含 result.url,指向圖片、影片或音訊檔案,檔案會保存 30 天。

為正式上線打造

每個 Mage API 請求都享有的功能

一組金鑰,通用所有模型

28 個圖片、影片和音訊模型,整合在同一個 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 可以做文字轉語音嗎?

可以。Seed Audio 能用你描述的聲音或已儲存的聲音參考朗讀腳本,並提供語速、音量和音高設定。同一個提示欄位也能生成音樂和音效。

生成的音訊最長可以多長?

Seed Audio 可生成最長 120 秒的片段。

Mage API 的費用是多少?

沒有訂閱制,也沒有月費。每次生成都依該模型的標示價格以 Gems 支付,標準方案中 1,000 Gems 為 $1。每個模型頁面都會列出預設設定下的價格,每次回應也會顯示實際扣款金額。生成失敗會退款;但被 Mage 內容政策封鎖的不會退款。若你的餘額不足以支付請求,系統會在扣款前直接拒絕。

使用 API 需要 Mage 會員資格嗎?

不需要。API 只使用 Gems。會員方案及其應用程式內無限生成的權益不適用於 API 請求,因此任何擁有 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 餘額,通用所有模型。只需為你生成的內容付費。

取得 API 金鑰閱讀 API 文件

相關內容