--- title: 通过 RunAPI 在 WorkBuddy 中使用 ElevenLabs — TTS MCP 指南 | RunAPI description: 通过 RunAPI MCP 服务器为 WorkBuddy 添加 ElevenLabs 文本转语音、语音转文本和音频分离能力。一个密钥、29 种语言、异步任务。 url: https://runapi.ai/zh-CN/workbuddy-elevenlabs.md canonical: https://runapi.ai/zh-CN/workbuddy-elevenlabs locale: zh-CN 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-CN/workbuddy-elevenlabs > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 ElevenLabs ElevenLabs 通过 RunAPI 提供六个音频端点——亚秒级延迟的 turbo-v2.5 TTS、覆盖 29 种语言的 multilingual-v2、用于多说话人对话的 dialogue-v3、音效生成、语音转文本转录以及人声分离。把 RunAPI 添加为 MCP 服务器一次，WorkBuddy 智能体用同一个密钥即可调用其中任意一个。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 六个音频端点 · 按字符计费 ### Prompt ```text 通过 runapi MCP 服务器，用 ElevenLabs 生成语音音频。 要求： - 调用 runapi MCP 服务器暴露的 ElevenLabs text_to_speech 工具。 - 将 model 设为 "text-to-speech-turbo-v2.5"。 - 文本："Welcome to RunAPI. This audio was generated from WorkBuddy." - 将 speed 设为 1.0，stability 设为 0.5，similarity_boost 设为 0.75。 - 该任务为异步任务——持续轮询直到 status 为 "completed"， 然后把音频 URL 给我。 ``` ### MCP 配置 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```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 服务器** - 在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp。ElevenLabs 全部六个端点——TTS、STT、对话、音效和音频分离——都成为一个密钥背后的可调用工具。 `export RUNAPI_API_KEY=runapi_xxx # MCP 服务器: runapi → https://runapi.ai/mcp ` 2. **让智能体朗读你的文本** - 在 WorkBuddy 中给出要朗读的文本并点名模型——低延迟英语用 text-to-speech-turbo-v2.5，29 种语言用 text-to-speech-multilingual-v2 并搭配 voice ID 和 language_code。需要调整声音时，说明 speed、stability 或 similarity_boost 的取值即可。 `model: text-to-speech-turbo-v2.5` 3. **在工作台中接收音频** - 任务异步运行。工作台智能体通过 MCP 工具持续轮询，直到 status 为 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 voice 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 服务器，WorkBuddy 智能体可访问 turbo-v2.5（英语亚秒级延迟）、multilingual-v2（29 种语言）、dialogue-v3（多说话人对话）、音效生成、语音转文本和人声分离功能。你可以通过 stability 和 similarity boost 两个参数调节声音的表现力与一致性——这一切都能在工作台里用一句平实的提示词完成。 ## ElevenLabs 使用场景 - **有声书与播客旁白** - 将长篇文字转化为采用一致角色声音的语音音频。让智能体保持较高的 stability 以维持旁白一致性，并让 similarity boost 贴近原始声音档案，在数小时的内容中保持声音稳定。 - **视频多语言配音** - 使用 multilingual-v2 和相同声音档案将视频内容配音为 29 种语言，制作保留原说话人声音特征的本地化版本——全部在工作台对话中发起。 - **视频和游戏制作音效** - 通过 text_to_sound 端点从文字描述生成自定义拟音音效、环境音频和音效提示，在 WorkBuddy 内以按需生成取代音效库搜索。 ## ElevenLabs + WorkBuddy 常见问题 ### WorkBuddy 通过 RunAPI 能使用哪些 ElevenLabs 端点？ 共六个——text_to_speech（turbo-v2.5 和 multilingual-v2）、text_to_dialogue（用于多说话人的 dialogue-v3）、text_to_sound（音效）、speech_to_text（转录）以及 isolate_audio（人声提取）。它们都在同一个 runapi MCP 服务器和 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 种语言，需要明确的 voice ID 和可选的 language_code。turbo 每字符的费用大约是前者的一半。 ### ElevenLabs 在 RunAPI 上如何计费？ 文本转语音和对话端点按输入文本的字符数计费。语音转文本按音频分钟数计费。音频分离按任务计费。用量与 WorkBuddy 调用的其他所有模型汇入同一个 RunAPI 余额——当前费率请查看 RunAPI 定价页面。 ### 我能在 WorkBuddy 中使用 ElevenLabs dialogue-v3 生成多说话人音频吗？ 可以。让智能体调用 text_to_dialogue 工具，使用模型 text-to-dialogue-v3，传入一个 dialogue 数组，其中每一项包含一段 text 和一个 voice ID。所有说话人的文本总量必须少于 5000 个字符。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未连接？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [ElevenLabs 模型 →](https://runapi.ai/zh-CN/models/elevenlabs.md) - 查看所有 ElevenLabs 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 ElevenLabs。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，让工作台智能体朗读你的文本——六个音频端点、一个密钥、按字符计费。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI ElevenLabs", "applicationCategory": "DeveloperApplication", "description": "通过 RunAPI MCP 服务器为 WorkBuddy 添加 ElevenLabs 文本转语音、语音转文本和音频分离能力。一个密钥、29 种语言、异步任务。", "url": "https://runapi.ai/zh-CN/workbuddy-elevenlabs" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy 通过 RunAPI 能使用哪些 ElevenLabs 端点？", "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 服务器和 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 种语言，需要明确的 voice ID 和可选的 language_code。turbo 每字符的费用大约是前者的一半。" } }, { "@type": "Question", "name": "ElevenLabs 在 RunAPI 上如何计费？", "acceptedAnswer": { "@type": "Answer", "text": "文本转语音和对话端点按输入文本的字符数计费。语音转文本按音频分钟数计费。音频分离按任务计费。用量与 WorkBuddy 调用的其他所有模型汇入同一个 RunAPI 余额——当前费率请查看 RunAPI 定价页面。" } }, { "@type": "Question", "name": "我能在 WorkBuddy 中使用 ElevenLabs dialogue-v3 生成多说话人音频吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。让智能体调用 text_to_dialogue 工具，使用模型 text-to-dialogue-v3，传入一个 dialogue 数组，其中每一项包含一段 text 和一个 voice ID。所有说话人的文本总量必须少于 5000 个字符。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 ElevenLabs", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，让工作台智能体用 ElevenLabs 朗读你的文本，并在对话中收到生成好的音频 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "将 RunAPI 添加为 MCP 服务器", "text": "在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp。ElevenLabs 全部六个端点——TTS、STT、对话、音效和音频分离——都成为一个密钥背后的可调用工具。", "url": "https://runapi.ai/zh-CN/workbuddy-elevenlabs#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "让智能体朗读你的文本", "text": "在 WorkBuddy 中给出要朗读的文本并点名模型——低延迟英语用 text-to-speech-turbo-v2.5，29 种语言用 text-to-speech-multilingual-v2 并搭配 voice ID 和 language_code。需要调整声音时，说明 speed、stability 或 similarity_boost 的取值即可。", "url": "https://runapi.ai/zh-CN/workbuddy-elevenlabs#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "在工作台中接收音频", "text": "任务异步运行。工作台智能体通过 MCP 工具持续轮询，直到 status 为 completed，然后把输出音频 URL 连同计费的字符数一起发回对话中。", "url": "https://runapi.ai/zh-CN/workbuddy-elevenlabs#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI ElevenLabs", "item": "https://runapi.ai/zh-CN/workbuddy-elevenlabs" } ] } ] ```