--- title: 透過 RunAPI 在 WorkBuddy 使用 ElevenLabs — TTS MCP 指南 | RunAPI description: 透過 RunAPI MCP server 將 ElevenLabs text-to-speech、speech-to-text 與音訊分離功能新增至 WorkBuddy。一組 key、29 種語言、非同步 task。 url: https://runapi.ai/zh-TW/workbuddy-elevenlabs.md canonical: https://runapi.ai/zh-TW/workbuddy-elevenlabs locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-elevenlabs zh-CN: https://runapi.ai/zh-CN/workbuddy-elevenlabs es: https://runapi.ai/es/workbuddy-elevenlabs ja: https://runapi.ai/ja/workbuddy-elevenlabs de: https://runapi.ai/de/workbuddy-elevenlabs fr: https://runapi.ai/fr/workbuddy-elevenlabs pt-BR: https://runapi.ai/pt-BR/workbuddy-elevenlabs ko: https://runapi.ai/ko/workbuddy-elevenlabs it: https://runapi.ai/it/workbuddy-elevenlabs nl: https://runapi.ai/nl/workbuddy-elevenlabs pl: https://runapi.ai/pl/workbuddy-elevenlabs tr: https://runapi.ai/tr/workbuddy-elevenlabs zh-TW: https://runapi.ai/zh-TW/workbuddy-elevenlabs zh-HK: https://runapi.ai/zh-HK/workbuddy-elevenlabs ar: https://runapi.ai/ar/workbuddy-elevenlabs x-default: https://runapi.ai/workbuddy-elevenlabs model: elevenlabs --- > HTML version: https://runapi.ai/zh-TW/workbuddy-elevenlabs > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 使用 ElevenLabs。 ElevenLabs 透過 RunAPI 提供六個音訊 endpoint — 具備次秒級延遲的 turbo-v2.5 TTS、支援 29 種語言的 multilingual-v2、用於多說話者對話的 dialogue-v3、音效、speech-to-text 轉錄，以及人聲分離。只要將 RunAPI 新增為 MCP server 一次，WorkBuddy agent 就能使用同一組 key 呼叫其中任何一項。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · 六個音訊 endpoint · 按字元計費 ### 提示詞 ```text 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 設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 回應 ```json { "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 1. **將 RunAPI 新增為 MCP server** - 在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後註冊名為 runapi、透過 streamable HTTP 指向 https://runapi.ai/mcp 的 MCP server。所有六個 ElevenLabs endpoint — TTS、STT、dialogue、音效和音訊分離 — 都會在一組 key 後方成為可呼叫工具。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **請 agent 朗讀你的文字** - 向 WorkBuddy 提供想朗讀的文字並指定 model — 使用 text-to-speech-turbo-v2.5 取得低延遲 English，或使用搭配 voice ID 與 language_code 的 text-to-speech-multilingual-v2 支援 29 種語言。若要微調聲音，可提及 speed、stability 或 similarity_boost。 `model: text-to-speech-turbo-v2.5` 3. **在工作台中接收音訊** - task 會以非同步方式執行。工作台 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 是自然語音輸出的首選 text-to-speech API。透過 RunAPI MCP server，WorkBuddy agent 可存取 turbo-v2.5（適用於 English 的次秒級延遲）、multilingual-v2（29 種語言）、dialogue-v3（多說話者對話）、音效生成、speech-to-text 轉錄及人聲分離。你可以透過 stability 和 similarity boost 滑桿微調聲音輸出，控制語音的表現力或一致性 — 全都能在工作台中透過自然語言提示詞完成。 ## ElevenLabs 使用情境 - **有聲書與 Podcast 旁白** - 將長篇文字轉換為使用一致角色聲音的語音音訊。請 agent 維持較高的 stability 以確保旁白一致性，並在數小時內容中讓 similarity boost 接近原始設定檔。 - **影片多語言配音** - 使用 multilingual-v2 和相同聲音設定檔，將影片內容配音為 29 種語言，製作保留原始說話者聲音特徵的在地化版本 — 全都可從工作台對話中提出要求。 - **影片與遊戲製作的音效** - 透過 text_to_sound endpoint，根據文字描述生成自訂 Foley 音效、環境音訊與聲音提示，以 WorkBuddy 中的隨需生成取代搜尋現成音訊素材庫。 ## ElevenLabs + WorkBuddy 常見問題 ### WorkBuddy 可透過 RunAPI 存取哪些 ElevenLabs endpoint？ 共有六項 — 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 和 similarity 設定？ 先將 stability 設為 0.5，similarity_boost 設為 0.75。較高的 stability 會讓聲音更一致，但表現力較低。audiobook 可嘗試 stability 0.6-0.8。對話內容則使用較低的 stability（0.3-0.5）以增加自然變化。你可以在 WorkBuddy 提示詞中直接說明這些數值。 ### turbo-v2.5 和 multilingual-v2 有何差異？ Turbo-v2.5 針對低延遲和英語優先輸出最佳化——未指定聲音時套用預設聲音。Multilingual-v2 支援 29 種語言，需要明確指定聲音 ID 及選填的 language_code。Turbo 每個字元的費用約為 multilingual-v2 的一半。 ### RunAPI 上 ElevenLabs 如何計費？ Text-to-speech 與 dialogue endpoint 依輸入文字的字元數計費。Speech-to-text 依音訊分鐘數計費。音訊分離依 task 計費。用量會與 WorkBuddy 呼叫的其他所有 model 合併計入同一個 RunAPI 餘額 — 請查看 RunAPI 定價頁面取得目前費率。 ### 我可以在 WorkBuddy 中使用 ElevenLabs dialogue-v3 製作多說話者音訊嗎？ 可以。請 agent 使用 model text-to-dialogue-v3 呼叫 text_to_dialogue 工具，並傳入 dialogue array，其中每個項目都包含 text 和 voice ID。所有說話者的文字總數必須低於 5000 個字元。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [ElevenLabs on RunAPI →](https://runapi.ai/zh-TW/models/elevenlabs.md) - 查看所有 ElevenLabs 變體、定價及 API 文件。 ## 立即在 WorkBuddy 試用 ElevenLabs。 取得免費 RunAPI key，將 MCP server 新增至 WorkBuddy，並請工作台 agent 朗讀你的文字 — 六個音訊 endpoint、一組 key、按字元計費。 [瀏覽模型 →](https://runapi.ai/zh-TW/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-TW/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [x402](https://runapi.ai/zh-TW/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) ### 法律 - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI ElevenLabs", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 將 ElevenLabs text-to-speech、speech-to-text 與音訊分離功能新增至 WorkBuddy。一組 key、29 種語言、非同步 task。", "url": "https://runapi.ai/zh-TW/workbuddy-elevenlabs" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy 可透過 RunAPI 存取哪些 ElevenLabs endpoint？", "acceptedAnswer": { "@type": "Answer", "text": "共有六項 — 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 後方。" } }, { "@type": "Question", "name": "要獲得最自然的聲音，應該使用什麼 stability 和 similarity 設定？", "acceptedAnswer": { "@type": "Answer", "text": "先將 stability 設為 0.5，similarity_boost 設為 0.75。較高的 stability 會讓聲音更一致，但表現力較低。audiobook 可嘗試 stability 0.6-0.8。對話內容則使用較低的 stability（0.3-0.5）以增加自然變化。你可以在 WorkBuddy 提示詞中直接說明這些數值。" } }, { "@type": "Question", "name": "turbo-v2.5 和 multilingual-v2 有何差異？", "acceptedAnswer": { "@type": "Answer", "text": "Turbo-v2.5 針對低延遲和英語優先輸出最佳化——未指定聲音時套用預設聲音。Multilingual-v2 支援 29 種語言，需要明確指定聲音 ID 及選填的 language_code。Turbo 每個字元的費用約為 multilingual-v2 的一半。" } }, { "@type": "Question", "name": "RunAPI 上 ElevenLabs 如何計費？", "acceptedAnswer": { "@type": "Answer", "text": "Text-to-speech 與 dialogue endpoint 依輸入文字的字元數計費。Speech-to-text 依音訊分鐘數計費。音訊分離依 task 計費。用量會與 WorkBuddy 呼叫的其他所有 model 合併計入同一個 RunAPI 餘額 — 請查看 RunAPI 定價頁面取得目前費率。" } }, { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 ElevenLabs dialogue-v3 製作多說話者音訊嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。請 agent 使用 model text-to-dialogue-v3 呼叫 text_to_dialogue 工具，並傳入 dialogue array，其中每個項目都包含 text 和 voice ID。所有說話者的文字總數必須低於 5000 個字元。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 使用 ElevenLabs", "description": "將 RunAPI 新增為 WorkBuddy 的 MCP server，請工作台 agent 使用 ElevenLabs 朗讀你的文字，完成的音訊 URL 會回傳至對話中。", "step": [ { "@type": "HowToStep", "position": 1, "name": "將 RunAPI 新增為 MCP server", "text": "在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後註冊名為 runapi、透過 streamable HTTP 指向 https://runapi.ai/mcp 的 MCP server。所有六個 ElevenLabs endpoint — TTS、STT、dialogue、音效和音訊分離 — 都會在一組 key 後方成為可呼叫工具。", "url": "https://runapi.ai/zh-TW/workbuddy-elevenlabs#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "請 agent 朗讀你的文字", "text": "向 WorkBuddy 提供想朗讀的文字並指定 model — 使用 text-to-speech-turbo-v2.5 取得低延遲 English，或使用搭配 voice ID 與 language_code 的 text-to-speech-multilingual-v2 支援 29 種語言。若要微調聲音，可提及 speed、stability 或 similarity_boost。", "url": "https://runapi.ai/zh-TW/workbuddy-elevenlabs#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "在工作台中接收音訊", "text": "task 會以非同步方式執行。工作台 agent 透過 MCP 工具輪詢，直到狀態為 completed，接著將輸出音訊 URL 與計費字元數一併回傳至對話中。", "url": "https://runapi.ai/zh-TW/workbuddy-elevenlabs#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI ElevenLabs", "item": "https://runapi.ai/zh-TW/workbuddy-elevenlabs" } ] } ] ```