人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本篇指南以 docs/content/zh-Hans/docs/manual/config/providers/speech/elevenlabs.md 为主体结合仓库中 provider 注册与设置页面的源码实现展开。读完你将掌握在 AIRI 中接入 ElevenLabs TTS 的完整流程获取并安全存放 API Key、填写服务商配置、验证连通性、选择模型与音色、调试发音参数并了解 AIRI 为 ElevenLabs 内置的模型清单、音色目录加载机制与 SSML 能力从而让 AIRI 的回复以你账户中真实存在的音色发声。为什么选择 ElevenLabs在 AIRI 的语音合成TTS服务商体系中ElevenLabs 的核心价值在于它直接对接你的 ElevenLabs 账户音色库。如果你已经拥有自定义音色或者希望直接使用 ElevenLabs 预置的 Aria、Bill 等官方声线在 AIRI 中完成 API Key 配置后即可在设置界面直接浏览、搜索并选择可用声音无需自己维护音色 ID 列表。从源码分类看ElevenLabs 属于付费云服务pricing: paid、deployment: cloud其注册定义位于 packages/provider-inference/src/providers/cloud/elevenlabs/index.ts任务类型为text-to-speech并在 packages/stage-ui/src/libs/providers/attributes.ts 中被标记为付费云服务商。第一步获取 API Key登录 ElevenLabs 账户进入控制台的API Keys 设置页面点击创建新的 API Key。为密钥设置便于识别的名称并根据实际用量设置适当的使用限制如每日额度上限以便在密钥泄露或异常消耗时能及时感知。复制密钥并妥善保存推荐放入密码管理器。⚠️API Key 安全不要把 API Key 提交到仓库、截图分享或发送给他人。若怀疑泄露请立即在 ElevenLabs 控制台撤销该密钥并重新创建同时在 AIRI 中更新配置。第二步在 AIRI 中配置服务商打开设置 → 服务商 → 语音合成在服务商列表中选择ElevenLabs界面中的展示名来自中文语言包见 packages/i18n/src/locales/zh-Hans/settings.yaml。将 API Key 粘贴到API Key基础设置输入框中。该字段在配置表单中类型为password不会明文展示。保留界面默认的 Base URL只有当你使用自己的 ElevenLabs 兼容网关时才需要修改。关于这两个字段源码中的配置 schema 给出了明确的规则packages/provider-inference/src/providers/cloud/elevenlabs/index.tsapiKey必填字符串创建 provider 实例时会先trim()去除首尾空白再传入baseUrl默认值为https://unspeech.hyp3r.link/v1/一个由 unspeech 库提供的 OpenAI 兼容代理端点AIRI 通过它统一访问各家语音服务voiceSettings包含similarityBoost默认 0.75与stability默认 0.5两个数值参数。配置校验器createElevenLabsValidators会在保存时执行以下检查apiKey为空 → 报错 API key is required.baseUrl为空 → 报错 Base URL is required.baseUrl不是合法绝对 URL需带http://或https://协议头→ 报错 Base URL is not absolute...baseUrl末尾缺少/→ 报错 Base URL must end with a trailing slash (/).。只有当apiKey与baseUrl都非空时才会触发自动校验validationRequiredWhen这也对应设置界面中 Ping API 按钮的启用条件。第三步验证配置Ping API点击该按钮测试网络是否连通、API Key 是否填写正确。这一操作实质上是调用上述配置校验器与 provider 初始化逻辑只有校验通过才会继续发起请求。选择模型和音色测试成功后进入设置 → 发声选择模型与想使用的声音。模型与音色列表由 AIRI 自动拉取详见下文内置模型清单与音色目录两节。输入一段短文本并点击试听能正常播放语音即表示配置成功。若未填写 API Key试听按钮会被禁用并提示需要填写 API Key 才能用哦对应 packages/stage-ui/src/components/scenarios/providers/speech-playground.vue 中的apiKeyConfigured判断。值得注意的是设置页packages/stage-pages/src/pages/settings/providers/speech/elevenlabs.vue会在你填写apiKey或baseUrl后的 500ms防抖内自动校验配置并通过loadVoicesForProvider预加载音色目录无需手动刷新。内置模型清单AIRI 为 ElevenLabs 预置的 TTS 模型AIRI 无需请求 ElevenLabs 的模型列表接口而是在 packages/provider-inference/src/providers/cloud/elevenlabs/list-models.ts 中内置了一份静态模型清单通过extraMethods.listModels暴露给设置界面packages/provider-inference/src/providers/cloud/elevenlabs/index.ts。主要可用于文本转语音can_do_text_to_speech: true的模型如下模型 ID名称特点支持语言单次请求最大字符数eleven_multilingual_v2Eleven Multilingual v2最拟真、情感最丰富的模型适合配音、有声书等创作场景支持 style 与 speaker boost29 种含中、日、韩10000eleven_flash_v2_5Eleven Flash v2.5超低延迟面向对话场景32 种40000eleven_turbo_v2_5Eleven Turbo v2.5高质量、低延迟兼顾速度与非英语语言32 种40000eleven_turbo_v2Eleven Turbo v2仅英文的低延迟模型仅英文30000eleven_flash_v2Eleven Flash v2英文超低延迟面向对话场景仅英文30000eleven_multilingual_v1Eleven Multilingual v1第一代多语言模型支持 10 种语言10 种10000eleven_monolingual_v1Eleven English v1第一代 TTS 模型仅英文仅英文10000AIRI 在设置页默认选择eleven_multilingual_v2defaultModel同时在传统发声设置页的模型下拉框中提供了eleven_monolingual_v1、eleven_multilingual_v1、eleven_multilingual_v2三个快捷选项见 packages/stage-pages/src/pages/settings/modules/speech.vue。模型清单中的character_cost_multiplier字段Multilingual v2 为 1Turbo/Flash 系列为 0.5反映了各模型的按字符计费倍率差异可作为日常使用的成本参考。测试用例 packages/stage-ui/src/libs/providers/providers/provider-definitions.test.ts 验证了默认baseUrl、voiceSettings默认值以及模型列表均从定义中正确加载且所有模型都归属于elevenlabs提供方。音色目录如何加载、排序与试听AIRI 通过extraMethods.listVoices实时拉取你的账户音色packages/provider-inference/src/providers/cloud/elevenlabs/index.ts使用unspeech的listVoices调用 ElevenLabs 音色接口返回的每个音色包含id、name、provider、previewURL试听音频地址与languages支持的语言及代码列表做了特殊排序把官方默认音色名字含 Aria 与 Bill 的音色整体挪到列表末尾使你的自定义音色排在前面方便优先选择。音色目录的加载由 packages/stage-ui/src/stores/modules/speech.ts 中的loadVoicesForProvider/loadVoiceCatalog流程驱动设置页通过VoiceCardManySelect组件展示音色卡片支持搜索、播放试听音频previewURL、手动输入自定义音色 ID并在选择后通过trackVoiceSelected记录分析事件。试听面板SpeechPlayground还提供语言徽标展示方便按语言过滤官方音色。ElevenLabs 特有的发音参数调优与通用服务商不同ElevenLabs 的设置页提供了一套专属音色参数对应中文语言包中的字段说明见 packages/i18n/src/locales/zh-Hans/settings.yaml其默认值定义在 packages/stage-pages/src/pages/settings/providers/speech/elevenlabs.vue参数默认值取值范围说明similarityBoost相似度修正0.750 ~ 1步进 0.01声音相似性与依从性越高越接近原始音色stability稳定性0.50 ~ 1步进 0.01语音稳定性和随机性越高发音越稳定、情绪起伏越小style风格00 ~ 1步进 0.01夸张的语音风格强度仅 Multilingual v2 支持useSpeakerBoost扬声器增强false开/关增强说话者的相似性仅 Multilingual v2 支持speed语速1.00.5 ~ 2.0步进 0.01语音生成速度pitch音高0-100% ~ 100%步进 1通用音高调节volume音量0-100% ~ 100%步进 1通用音量调节这些参数通过watch实时写入 provider 配置providerConfig.style、providerConfig.stability等并在生成语音时随provider.speech(model, {...providerConfig, ...defaultVoiceSettings})一并提交给服务端。注意源码中的配置 schema 仅固化similarityBoost与stability两个默认值而style、useSpeakerBoost等参数由设置页补齐默认值后透传。SSML 支持从 packages/stage-ui/src/stores/modules/speech.ts 可以看出elevenlabs属于 AIRI 支持 SSML语音合成标记语言的服务商之一同列还有microsoft-speech、azure-speech。这意味着你可以在设置 → 发声中开启 Enable SSML随后在试听面板输入原始 SSML 文本例如用prosody pitch10% rate1.2精细控制语调与语速进行测试对话生成时若开启 SSMLAIRI 会自动调用generateSSML将普通文本包装为speakvoice name...结构的 SSML若设置了 pitch/speed/volume 还会生成prosody节点见 packages/stage-ui/src/stores/modules/speech.ts并将pitch参数编码为带正负号的百分比形式如10%/-5%。排查与常见问题Ping API 失败依次检查 API Key 是否复制完整且未含空格、Base URL 是否为默认值或合法网关地址必须带协议头并以/结尾、账户余额与额度是否充足、网络能否访问外网。能列出模型但没有声音确认设置 → 发声中已选择有效的模型与音色并检查该模型是否支持所选音色不同模型支持的语言范围不同可参考上文模型表格。试听按钮置灰提示需要填写 API Key 才能用哦时说明 provider 配置尚未通过校验请回到服务商设置页确认 API Key 已保存。音色列表为空确认账户中存在可用音色配置变更后 AIRI 会自动重新加载音色目录500ms 防抖也可通过切换模型触发刷新。相关源码路径速查Provider 注册与配置校验packages/provider-inference/src/providers/cloud/elevenlabs/index.ts内置模型清单packages/provider-inference/src/providers/cloud/elevenlabs/list-models.ts设置页参数面板 试听面板packages/stage-pages/src/pages/settings/providers/speech/elevenlabs.vue发声设置模块packages/stage-pages/src/pages/settings/modules/speech.vue语音生成与 SSML 管线packages/stage-ui/src/stores/modules/speech.ts试听面板组件packages/stage-ui/src/components/scenarios/providers/speech-playground.vue覆盖测试packages/stage-ui/src/libs/providers/providers/provider-definitions.test.ts中文界面文案packages/i18n/src/locales/zh-Hans/settings.yaml至此从密钥获取、服务商配置、连通性验证到模型选择、音色加载与发音参数调优你已掌握在 AIRI 中启用 ElevenLabs TTS 的全链路方法。完成配置后AIRI 的每次回复都会经由你选定的模型与音色实时合成语音输出。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐warp 安装指南Windows、Linux、macOS 与 Docker 部署一次讲清warp 安装指南Windows、Linux、macOS 与 Docker 部署一次讲清 warp 是 NVIDIA 出品的 Python GPU 仿真框架高性能计算物理引擎图形学机器人AIRI 集成 CometAPI 语音合成TTS从 API Key 配置到实时语音回复的完整指南AIRI 集成 CometAPI 语音合成TTS从 API Key 配置到实时语音回复的完整指南 CometAPI 通过 OpenAI 兼容接口为 AIRAI 应用人工智能大模型数字人AI Agent语音前端后端桌面应用移动开发即时通讯3D渲染AIRI 接入 Deepgram Aura 语音合成API Key 配置、模型与音色选择实战指南AIRI 接入 Deepgram Aura 语音合成API Key 配置、模型与音色选择实战指南 本文以 AIRI 项目的手册文档 docs/content/人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇115proxy-for-kodi完整指南让Kodi不下载直连115云盘原码播放下一篇GTA5强化工具YimMenu超详细上手指南从编译注入到Lua扩展一次讲透创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考