跳至主要內容

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-v4Eleven v4是

選項

Eleven Speech 參數

以下為所有版本可接受的值;個別版本可能提供較少選項。各版本的選項請參閱文件。

欄位可用值
voicedarian, 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

  • 音訊 · 每次 19 Gems 起

    Seed Audio API

    一個提示詞,生成人聲、音樂和音效

  • 音訊 · 113 Gems 起

    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 餘額,通用所有模型。只需為你生成的內容付費。