Claude 訪客:新帳戶可在 30 天內獲得 $1.00 API 贈送額度。每人限領一次,僅用於 API 用量。
在 WorkBuddy 中使用 ElevenLabs。
ElevenLabs 透過 RunAPI 提供六個音訊 endpoint — 延遲低於一秒的 turbo-v2.5 TTS、支援 29 種語言的 multilingual-v2、多說話者對話的 dialogue-v3、音效、語音轉文字轉錄,以及人聲分離。只需將 RunAPI 加入為 MCP server 一次,WorkBuddy agent 即可以同一個金鑰呼叫所有功能。
Using the runapi MCP server, generate speech audio with ElevenLabs.
Requirements:
- Call the ElevenLabs text_to_speech tool exposed by the runapi MCP server.
- Set model to "text-to-speech-turbo-v2.5".
- Text: "Welcome to RunAPI. This audio was generated from WorkBuddy."
- Set speed to 1.0, stability to 0.5, similarity_boost to 0.75.
- The task is async — keep polling until the status is "completed",
then give me the audio URL.
{
"mcp_servers": {
"runapi": {
"url": "https://runapi.ai/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer $RUNAPI_API_KEY"
}
}
}
}
{
"task_id": "tsk_abc123",
"status": "completed",
"model": "text-to-speech-turbo-v2.5",
"output": {
"audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3",
"characters_billed": 62
}
}
三步驟在 WorkBuddy 中使用 ElevenLabs
將 RunAPI 加入為 MCP server
在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY,然後透過 streamable HTTP 將名為 runapi 的 MCP server 註冊至 https://runapi.ai/mcp。所有六個 ElevenLabs endpoint — TTS、STT、對話、音效及音訊分離 — 均以一個金鑰作為可呼叫工具。
export RUNAPI_API_KEY=runapi_xxx
# MCP server: runapi → https://runapi.ai/mcp
請 agent 朗讀您的文字
向 WorkBuddy 提供您想要朗讀的文字並指定模型 — 低延遲英語使用 text-to-speech-turbo-v2.5,或使用 text-to-speech-multilingual-v2 搭配 voice ID 及 language_code 支援 29 種語言。如需調整聲音,可提及 speed、stability 或 similarity_boost。
model: text-to-speech-turbo-v2.5
在工作台中接收音訊
任務以非同步方式執行。工作台 agent 透過 MCP 工具輪詢直至狀態顯示為 completed,然後將輸出音訊 URL 連同已計費的字元數發佈至對話中。
"status": "completed"
ElevenLabs text_to_speech 參數
| 參數 | 類型 | 說明 |
|---|---|---|
model |
string |
必填。text-to-speech-turbo-v2.5(低延遲)或 text-to-speech-multilingual-v2(支援 29 種語言)。 |
text |
string |
必填。要轉換為語音的文字。最多 5000 個字元。 |
voice |
string |
ElevenLabs 聲音 ID。multilingual-v2 必填。Turbo-v2.5 在省略時使用預設聲音。 |
speed |
float |
選填。播放速度倍數。範圍 0.7 至 1.2。 |
stability |
float |
選填。聲音一致性。範圍 0.0 至 1.0。數值越低,表現力越強。 |
similarity_boost |
float |
選填。聲音相似度強制程度。範圍 0.0 至 1.0。 |
什麼是 WorkBuddy 上的 ElevenLabs?
ElevenLabs 是生成自然語音輸出的首選文字轉語音 API。透過 RunAPI MCP server,WorkBuddy agent 可存取 turbo-v2.5(英語低延遲)、multilingual-v2(29 種語言)、dialogue-v3(多說話者對話)、音效生成、語音轉文字轉錄及人聲分離。您可透過 stability 及 similarity boost 調節器調整聲音輸出,控制聲音的表現力或一致性 — 全程只需在工作台以自然語言提示。
ElevenLabs 使用場景
有聲書及 Podcast 旁白
使用一致的角色聲音將長篇文字轉為語音。請 agent 在大量內容中保持高 stability 以確保旁白一致性,並將 similarity boost 保持接近原始聲音檔案。
視頻多語言配音
使用 multilingual-v2 搭配相同聲音檔案,將影片內容配音成 29 種語言,製作保留原說話者聲音特徵的本地化版本 — 全程透過工作台對話請求。
視頻及遊戲製作的音效
透過 text_to_sound endpoint 從文字描述生成自訂 Foley 音效、環境音訊及聲音提示,以按需生成取代在 WorkBuddy 內搜尋素材庫音效。
ElevenLabs + WorkBuddy 常見問題
共六個 — text_to_speech(turbo-v2.5 及 multilingual-v2)、text_to_dialogue(dialogue-v3,支援多位說話者)、text_to_sound(音效)、speech_to_text(轉錄)及 isolate_audio(人聲提取)。全部在同一個 runapi MCP server 及 RUNAPI_API_KEY 後端。
從 stability 0.5、similarity_boost 0.75 開始。較高的 stability 使聲音更一致但表現力較低。有聲書建議 stability 0.6-0.8。對話內容則使用較低 stability(0.3-0.5)以增加自然變化。您可在 WorkBuddy 提示詞中直接指定這些數值。
Turbo-v2.5 針對低延遲及英語優先輸出進行優化——未指定聲音時會套用預設聲音。Multilingual-v2 支援 29 種語言,需要明確提供聲音 ID 及可選的 language_code。Turbo 每字元費用約為前者的一半。
文字轉語音及對話 endpoint 按輸入文字的字元數計費。語音轉文字按音訊分鐘數計費。音訊分離按任務計費。用量與 WorkBuddy 呼叫的所有其他模型共用同一個 RunAPI 餘額 — 請查閱 RunAPI 定價頁面了解最新費率。
可以。請 agent 呼叫 text_to_dialogue 工具,使用模型 text-to-dialogue-v3,傳入一個 dialogue 陣列,其中每個項目包含 text 及 voice ID。所有說話者的文字總長度須少於 5000 個字元。
立即在 WorkBuddy 中試用 ElevenLabs。
獲取免費 RunAPI 金鑰,將 MCP server 加入 WorkBuddy,並請工作台 agent 朗讀您的文字 — 六個音訊 endpoint、一個金鑰、按字元計費。