--- title: 透過 RunAPI 在 WorkBuddy 使用 ElevenLabs — TTS MCP 指南 | RunAPI description: 透過 RunAPI MCP server 將 ElevenLabs 文字轉語音、語音轉文字及音訊分離功能加入 WorkBuddy。一個金鑰、29 種語言、非同步任務。 url: https://runapi.ai/zh-HK/workbuddy-elevenlabs.md canonical: https://runapi.ai/zh-HK/workbuddy-elevenlabs locale: zh-HK 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-HK/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、音效、語音轉文字轉錄，以及人聲分離。只需將 RunAPI 加入為 MCP server 一次，WorkBuddy agent 即可以同一個金鑰呼叫所有功能。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/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，然後透過 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 ` 2. **請 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` 3. **在工作台中接收音訊** - 任務以非同步方式執行。工作台 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 常見問題 ### 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 使聲音更一致但表現力較低。有聲書建議 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 每字元費用約為前者的一半。 ### RunAPI 上的 ElevenLabs 如何計費？ 文字轉語音及對話 endpoint 按輸入文字的字元數計費。語音轉文字按音訊分鐘數計費。音訊分離按任務計費。用量與 WorkBuddy 呼叫的所有其他模型共用同一個 RunAPI 餘額 — 請查閱 RunAPI 定價頁面了解最新費率。 ### 我可以在 WorkBuddy 中使用 ElevenLabs dialogue-v3 生成多說話者音訊嗎？ 可以。請 agent 呼叫 text_to_dialogue 工具，使用模型 text-to-dialogue-v3，傳入一個 dialogue 陣列，其中每個項目包含 text 及 voice ID。所有說話者的文字總長度須少於 5000 個字元。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [ElevenLabs on RunAPI →](https://runapi.ai/zh-HK/models/elevenlabs.md) - 查看所有 ElevenLabs 變體、定價及 API 文件。 ## 立即在 WorkBuddy 中試用 ElevenLabs。 獲取免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，並請工作台 agent 朗讀您的文字 — 六個音訊 endpoint、一個金鑰、按字元計費。 [瀏覽模型 →](https://runapi.ai/zh-HK/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI ElevenLabs", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 將 ElevenLabs 文字轉語音、語音轉文字及音訊分離功能加入 WorkBuddy。一個金鑰、29 種語言、非同步任務。", "url": "https://runapi.ai/zh-HK/workbuddy-elevenlabs" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@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 使聲音更一致但表現力較低。有聲書建議 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 每字元費用約為前者的一半。" } }, { "@type": "Question", "name": "RunAPI 上的 ElevenLabs 如何計費？", "acceptedAnswer": { "@type": "Answer", "text": "文字轉語音及對話 endpoint 按輸入文字的字元數計費。語音轉文字按音訊分鐘數計費。音訊分離按任務計費。用量與 WorkBuddy 呼叫的所有其他模型共用同一個 RunAPI 餘額 — 請查閱 RunAPI 定價頁面了解最新費率。" } }, { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 ElevenLabs dialogue-v3 生成多說話者音訊嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。請 agent 呼叫 text_to_dialogue 工具，使用模型 text-to-dialogue-v3，傳入一個 dialogue 陣列，其中每個項目包含 text 及 voice ID。所有說話者的文字總長度須少於 5000 個字元。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 ElevenLabs", "description": "在 WorkBuddy 中將 RunAPI 加入為 MCP server，請工作台 agent 以 ElevenLabs 朗讀您的文字，並在對話中收到完成的音訊 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "將 RunAPI 加入為 MCP server", "text": "在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後透過 streamable HTTP 將名為 runapi 的 MCP server 註冊至 https://runapi.ai/mcp。所有六個 ElevenLabs endpoint — TTS、STT、對話、音效及音訊分離 — 均以一個金鑰作為可呼叫工具。", "url": "https://runapi.ai/zh-HK/workbuddy-elevenlabs#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "請 agent 朗讀您的文字", "text": "向 WorkBuddy 提供您想要朗讀的文字並指定模型 — 低延遲英語使用 text-to-speech-turbo-v2.5，或使用 text-to-speech-multilingual-v2 搭配 voice ID 及 language_code 支援 29 種語言。如需調整聲音，可提及 speed、stability 或 similarity_boost。", "url": "https://runapi.ai/zh-HK/workbuddy-elevenlabs#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "在工作台中接收音訊", "text": "任務以非同步方式執行。工作台 agent 透過 MCP 工具輪詢直至狀態顯示為 completed，然後將輸出音訊 URL 連同已計費的字元數發佈至對話中。", "url": "https://runapi.ai/zh-HK/workbuddy-elevenlabs#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "主頁", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI ElevenLabs", "item": "https://runapi.ai/zh-HK/workbuddy-elevenlabs" } ] } ] ```