Mage API · 音訊模型
Eleven Speech API
ElevenLabs v4:可自由掌控的擬真語音
POST https://api.mage.space/v1/eleven_speech/generate重點速覽
Eleven Speech API 透過 Mage 執行 Eleven v4,端點為 POST https://api.mage.space/v1/eleven_speech/generate。以預設設定發送一次請求費用為 30 Gems(約 $0.03),無需訂閱。Eleven Speech 不支援 @handle 提及。
- 音訊輸出
- 1版本
- 30預設每段影片所需 Gems
- $0.03約合美元
總覽
Eleven Speech API 能做什麼
ElevenLabs v4 文字轉語音,提供 16 種聲音、支援 90 多種語言,還能用 [whispers] 或 [laughs] 等音訊標籤逐句控制語氣。
ElevenLabs 富有表現力的文字轉語音,支援 90 多種語言,輸出的 MP3 長度與文字相符。方括號中的音訊標籤可以引導語氣並加入音效提示:[whispers]、[laughs]、[sarcastic]、[door slams]。
僅憑提示詞即可生成。
快速開始
呼叫 Eleven Speech API
設定 MAGE_API_KEY、送出請求到 /eleven_speech/generate,然後輪詢 status_url,直到請求完成。
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_speech/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
"model_id": "eleven-v4"
}' | 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_speech', {
prompt: 'Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.',
model_id: 'eleven-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("eleven_speech", {
"prompt": "Every lighthouse keeps one promise... to stay lit until morning. [softly] And this one never broke it.",
"model_id": "eleven-v4",
})
print(request["result"]["url"])模型
Eleven Speech 的 model_id 值
傳入 model_id 即可選擇版本。未指定時,請求會使用預設版本。
| model_id | 名稱 | 預設 |
|---|---|---|
| eleven-v4 | Eleven v4 | 是 |
選項
Eleven Speech 參數
以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。
| 欄位 | 可用值 |
|---|---|
| voice | darian, talia, elara, baxter, eldrin, elowen, kaelen, lawrence, alicia, maisie, warren, jade, caleb, sawyer, florence, wyatt |
規則
Eleven Speech API 的限制
- 提示詞即為要朗讀的文字,最多 5000 個字元,音訊標籤也計入。
- `voice` 可選擇 darian、talia、elara、baxter、eldrin、elowen、kaelen、lawrence、alicia、maisie、warren、jade、caleb、sawyer、florence、wyatt 其中之一。
- `stability` 的範圍從 0(更富表現力)到 1(更穩定)。
更多音訊模型
Mage 上的其他 AI 音訊生成 API
Seed Audio API
一個提示詞,生成人聲、音樂和音效
Eleven Music API
ElevenLabs 歌曲生成,有人聲或純音樂皆可
常見問題
常見問題
Eleven Speech API 的費用是多少?
以預設設定(Eleven v4)發送一次 Eleven Speech 請求,費用為 30 Gems,約 $0.03。其他解析度、長度和版本會影響價格,實際扣款金額會顯示在回應中。生成失敗時會退還 Gems;若內容遭 Mage 的內容政策封鎖,則不予退還。
Eleven Speech API 的端點是什麼?
使用 POST https://api.mage.space/v1/eleven_speech/generate,並在 Authorization: Bearer 標頭中帶上你的 Mage API 金鑰。回應會包含 status_url,可用來輪詢結果。
我可以呼叫哪些 Eleven Speech 模型?
eleven-v4(Eleven v4)。預設為 Eleven v4。
Eleven Speech 支援參考圖片或角色嗎?
Eleven Speech 不接受圖片、影片或音訊輸入,也不支援 @handle 提及。
我可以在 Claude 或 ChatGPT 中使用 Eleven Speech 嗎?
可以。將 Mage MCP 伺服器連接到 Claude、ChatGPT、Claude Code、Grok 或 Cursor,然後直接指名要用 Eleven Speech。你的助理會用 get_model 讀取可用選項,並在生成前告知價格。
Eleven Speech 的結果會保存多久?
結果與輸入內容會保存 30 天。想留存的內容,請自行下載到你的儲存空間。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。