人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本篇指南讲解如何在自托管的 AIRI 中接入由 Bilibili 开源的 Index-TTS本地 TTS服务AIRI 通过本地 HTTP 服务与 Index-TTS 通信默认访问http://localhost:11996/tts/语音数据始终停留在本地网络。读完本文你将掌握本地服务启动、Base URL 配置、Provider Playground 验证以及最终在「Modules → Speech」中启用回复语音的完整流程并了解底层提供者实现与故障排查方法。为什么选择 Index-TTSIndex-TTS 是 AIRI 语音提供者目录中的本地部署类、免费方案。从仓库中的提供者属性表可以看出index-tts-vllm被标记为freeLocal免费 本地部署与 ElevenLabs、MiniMax 等云端付费方案形成鲜明对比参见 packages/stage-ui/src/libs/providers/attributes.ts 中的providerAttributesById映射。官方文档给出的选择理由是如果你已经在本地运行 Index-TTS并希望声音数据保留在本地网络内即可选择此方案。这意味着音频合成请求不会离开你的局域网或本机适合对数据隐私有要求的自托管场景。启动本地 Index-TTS 服务接入 AIRI 前需要先让 Index-TTS 服务在本机可用按照 Index-TTS 官方部署说明启动服务典型部署方式为 vLLM 推理服务。AIRI 默认连接http://localhost:11996/tts/如果你使用了其他主机或端口请记录下完整的 Base URL 地址。确认服务可以返回模型和声音voice信息——这一步是后续验证配置是否成功的前提。从 AIRI 的提供者实现源码可以确认默认地址与模型 ID// packages/provider-inference/src/providers/local/index-tts-vllm/index.ts const indexTtsConfigSchema z.object({ baseUrl: z.string().default(http://localhost:11996/tts/), model: z.string().default(IndexTTS-1.5), })即 Base URL 默认值为http://localhost:11996/tts/模型 ID 默认值为IndexTTS-1.5。本地服务安全警告官方文档明确警告不要将本地服务端口暴露给不受信任的公网。如果修改了服务监听地址请自行保证服务访问安全例如通过防火墙限制来源、使用反向代理加认证等方式。在 AIRI 中配置 Index-TTS 提供者配置入口打开Settings → Providers → Speech → Bilibili / IndexTTS。在提供者设置页面中主要需要填写Base URL本地服务的完整地址。配置完成后AIRI 会调用服务的audio/voices接口来获取可用音色列表其实现位于提供者源码的voicesUrl函数function voicesUrl(config: IndexTtsConfig) { return ${config.baseUrl ?? http://localhost:11996/tts/}audio/voices }也就是说AIRI 实际访问的是{你的 Base URL}/audio/voices该接口需要返回一个 JSON 对象其键名即被解析为可用音色 ID每个音色同时标记为支持中文cn与英文en。音色列表的解析逻辑在listVoices中listVoices: async (config) { const response await fetch(voicesUrl(config)) if (!response.ok) throw new Error(Failed to fetch voices: ${response.statusText}) const voices await response.json() as Recordstring, unknown return Object.keys(voices).map(voice ({ id: voice, name: voice, provider: index-tts-vllm, languages: [{ code: cn, title: Chinese }, { code: en, title: English }], })) },如果服务无法返回该接口数据音色列表会为空这是后续故障排查的核心线索。配置校验机制AIRI 内置了对提供者配置的校验器validator。当 Base URL 为空时会提示 Base URL is required. Default to http://localhost:11996/tts/ for Index-TTS.填写后 AIRI 会使用5 秒超时的AbortController向audio/voices发起探测请求根据 HTTP 状态判断服务是否可达超时或连接失败会分别给出IndexTTS unreachable与IndexTTS connection failed错误信息。相关实现见 packages/provider-inference/src/providers/local/index-tts-vllm/index.ts 的validators.validateConfig。支持能力与版本提示提供者 ID 为index-tts-vllm显示名称为Index-TTS by Bilibili能力类型为text-to-speech注册入口见 packages/provider-inference/src/providers/index.tsproviderIndexTtsVllm。模型清单listModels固定返回IndexTTS-1.5说明这是该 vLLM 部署对应的默认模型。目前尚未支持 IndexTTS2设置页顶部会显示紫色 Callout 提示「暂不支持 / 目前尚未支持 IndexTTS2请使用 IndexTTS」见 packages/i18n/src/locales/zh-Hans/settings.yaml 与 packages/stage-pages/src/pages/settings/providers/speech/index-tts-vllm.vue。验证配置使用 Provider Playground配置完成后在同一设置页面即可直接验证在provider playground中选择一个可用音色该页面会使用已配置的 Index-TTS 服务以及 AIRI 的默认模型 IDIndexTTS-1.5。在播放台输入一段短文本确认能够播放音频。Playground 页面的默认测试文本为Hello! This is a test of the Index TTS Speech synthesis?.它通过speechStore.speech()将输入文本、音色与模型 ID 交给xsai/generate-speech完成合成。从源码看前端在onMounted时会主动调用loadVoicesForProvider(index-tts-vllm)拉取音色目录见 packages/stage-pages/src/pages/settings/providers/speech/index-tts-vllm.vue音色目录请求与合成调用均由 packages/stage-ui/src/stores/modules/speech.ts 中的loadVoicesForProvider/speech统一管理。启用 AIRI 回复语音Playground 验证通过只代表提供者本身可用并不会自动让 AIRI 在普通回复中使用语音。要真正启用还需要打开Settings → Modules → Speech然后选择语音提供者为Bilibili / IndexTTS选择模型 IDIndexTTS-1.5选择一个音色。完成这三步后AIRI 的正常对话回复才会调用 Index-TTS 进行语音合成。若语音模块仍然保持默认的speech-noop提供者则不会产生任何 TTS 输出。故障排查症状检查项无法连接配置校验失败 / Playground 无音频1. 确认本地 Index-TTS 服务确实在运行2. 确认 Base URL 中端口正确默认119963. 检查本机防火墙或反向代理是否放行该端口。音色列表为空检查服务的audio/voices接口是否可用完整路径为{Base URL}/audio/voices并确认它返回的是以音色名称为键的 JSON 对象。回复无语音输出确认已在Modules → Speech中选择提供者、模型IndexTTS-1.5与音色Playground 单独测试不会启用回复语音。总结AIRI 将 Index-TTS 视为一个标准的本地 HTTP TTS 提供者index-tts-vllm部署好本地服务后在Settings → Providers → Speech → Bilibili / IndexTTS填写 Base URL通过 Playground 验证音色与合成最后在Modules → Speech中启用该提供者与IndexTTS-1.5模型即可让 AIRI 的回复语音完全运行在本地网络之内。所有配置参数默认地址、默认模型、5 秒探测超时、audio/voices音色接口都可以在上述源码路径中逐一印证。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐在 AIRI 中接入本地 Index-TTS 语音合成服务启动、配置与源码解析在 AIRI 中接入本地 Index TTS 语音合成服务启动、配置与源码解析 Index TTSIndex TTS by Bilibili是 AIRI人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端AIRI 接入本地 Index-TTS自托管语音合成服务的完整配置指南AIRI 接入本地 Index TTS自托管语音合成服务的完整配置指南 本文以 AIRI 内置的 Bilibili / IndexTTS 提供者为主线讲解如人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务AIRI 接入 Player2 本地语音合成服务Base URL 配置、音色验证与模块启用全指南AIRI 接入 Player2 本地语音合成服务Base URL 配置、音色验证与模块启用全指南 Player2 Speech 是一款通过本地服务接入 AIR人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务上一篇JavaScript模块化开发终极指南从CommonJS到ES6模块的完整演进下一篇Android-DataBackup Root环境配置Magisk/KernelSU/APatch全支持创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AIRI 接入 Index-TTS 本地语音合成：从服务部署到回复启用全指南
人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本篇指南讲解如何在自托管的 AIRI 中接入由 Bilibili 开源的 Index-TTS本地 TTS服务AIRI 通过本地 HTTP 服务与 Index-TTS 通信默认访问http://localhost:11996/tts/语音数据始终停留在本地网络。读完本文你将掌握本地服务启动、Base URL 配置、Provider Playground 验证以及最终在「Modules → Speech」中启用回复语音的完整流程并了解底层提供者实现与故障排查方法。为什么选择 Index-TTSIndex-TTS 是 AIRI 语音提供者目录中的本地部署类、免费方案。从仓库中的提供者属性表可以看出index-tts-vllm被标记为freeLocal免费 本地部署与 ElevenLabs、MiniMax 等云端付费方案形成鲜明对比参见 packages/stage-ui/src/libs/providers/attributes.ts 中的providerAttributesById映射。官方文档给出的选择理由是如果你已经在本地运行 Index-TTS并希望声音数据保留在本地网络内即可选择此方案。这意味着音频合成请求不会离开你的局域网或本机适合对数据隐私有要求的自托管场景。启动本地 Index-TTS 服务接入 AIRI 前需要先让 Index-TTS 服务在本机可用按照 Index-TTS 官方部署说明启动服务典型部署方式为 vLLM 推理服务。AIRI 默认连接http://localhost:11996/tts/如果你使用了其他主机或端口请记录下完整的 Base URL 地址。确认服务可以返回模型和声音voice信息——这一步是后续验证配置是否成功的前提。从 AIRI 的提供者实现源码可以确认默认地址与模型 ID// packages/provider-inference/src/providers/local/index-tts-vllm/index.ts const indexTtsConfigSchema z.object({ baseUrl: z.string().default(http://localhost:11996/tts/), model: z.string().default(IndexTTS-1.5), })即 Base URL 默认值为http://localhost:11996/tts/模型 ID 默认值为IndexTTS-1.5。本地服务安全警告官方文档明确警告不要将本地服务端口暴露给不受信任的公网。如果修改了服务监听地址请自行保证服务访问安全例如通过防火墙限制来源、使用反向代理加认证等方式。在 AIRI 中配置 Index-TTS 提供者配置入口打开Settings → Providers → Speech → Bilibili / IndexTTS。在提供者设置页面中主要需要填写Base URL本地服务的完整地址。配置完成后AIRI 会调用服务的audio/voices接口来获取可用音色列表其实现位于提供者源码的voicesUrl函数function voicesUrl(config: IndexTtsConfig) { return ${config.baseUrl ?? http://localhost:11996/tts/}audio/voices }也就是说AIRI 实际访问的是{你的 Base URL}/audio/voices该接口需要返回一个 JSON 对象其键名即被解析为可用音色 ID每个音色同时标记为支持中文cn与英文en。音色列表的解析逻辑在listVoices中listVoices: async (config) { const response await fetch(voicesUrl(config)) if (!response.ok) throw new Error(Failed to fetch voices: ${response.statusText}) const voices await response.json() as Recordstring, unknown return Object.keys(voices).map(voice ({ id: voice, name: voice, provider: index-tts-vllm, languages: [{ code: cn, title: Chinese }, { code: en, title: English }], })) },如果服务无法返回该接口数据音色列表会为空这是后续故障排查的核心线索。配置校验机制AIRI 内置了对提供者配置的校验器validator。当 Base URL 为空时会提示 Base URL is required. Default to http://localhost:11996/tts/ for Index-TTS.填写后 AIRI 会使用5 秒超时的AbortController向audio/voices发起探测请求根据 HTTP 状态判断服务是否可达超时或连接失败会分别给出IndexTTS unreachable与IndexTTS connection failed错误信息。相关实现见 packages/provider-inference/src/providers/local/index-tts-vllm/index.ts 的validators.validateConfig。支持能力与版本提示提供者 ID 为index-tts-vllm显示名称为Index-TTS by Bilibili能力类型为text-to-speech注册入口见 packages/provider-inference/src/providers/index.tsproviderIndexTtsVllm。模型清单listModels固定返回IndexTTS-1.5说明这是该 vLLM 部署对应的默认模型。目前尚未支持 IndexTTS2设置页顶部会显示紫色 Callout 提示「暂不支持 / 目前尚未支持 IndexTTS2请使用 IndexTTS」见 packages/i18n/src/locales/zh-Hans/settings.yaml 与 packages/stage-pages/src/pages/settings/providers/speech/index-tts-vllm.vue。验证配置使用 Provider Playground配置完成后在同一设置页面即可直接验证在provider playground中选择一个可用音色该页面会使用已配置的 Index-TTS 服务以及 AIRI 的默认模型 IDIndexTTS-1.5。在播放台输入一段短文本确认能够播放音频。Playground 页面的默认测试文本为Hello! This is a test of the Index TTS Speech synthesis?.它通过speechStore.speech()将输入文本、音色与模型 ID 交给xsai/generate-speech完成合成。从源码看前端在onMounted时会主动调用loadVoicesForProvider(index-tts-vllm)拉取音色目录见 packages/stage-pages/src/pages/settings/providers/speech/index-tts-vllm.vue音色目录请求与合成调用均由 packages/stage-ui/src/stores/modules/speech.ts 中的loadVoicesForProvider/speech统一管理。启用 AIRI 回复语音Playground 验证通过只代表提供者本身可用并不会自动让 AIRI 在普通回复中使用语音。要真正启用还需要打开Settings → Modules → Speech然后选择语音提供者为Bilibili / IndexTTS选择模型 IDIndexTTS-1.5选择一个音色。完成这三步后AIRI 的正常对话回复才会调用 Index-TTS 进行语音合成。若语音模块仍然保持默认的speech-noop提供者则不会产生任何 TTS 输出。故障排查症状检查项无法连接配置校验失败 / Playground 无音频1. 确认本地 Index-TTS 服务确实在运行2. 确认 Base URL 中端口正确默认119963. 检查本机防火墙或反向代理是否放行该端口。音色列表为空检查服务的audio/voices接口是否可用完整路径为{Base URL}/audio/voices并确认它返回的是以音色名称为键的 JSON 对象。回复无语音输出确认已在Modules → Speech中选择提供者、模型IndexTTS-1.5与音色Playground 单独测试不会启用回复语音。总结AIRI 将 Index-TTS 视为一个标准的本地 HTTP TTS 提供者index-tts-vllm部署好本地服务后在Settings → Providers → Speech → Bilibili / IndexTTS填写 Base URL通过 Playground 验证音色与合成最后在Modules → Speech中启用该提供者与IndexTTS-1.5模型即可让 AIRI 的回复语音完全运行在本地网络之内。所有配置参数默认地址、默认模型、5 秒探测超时、audio/voices音色接口都可以在上述源码路径中逐一印证。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐在 AIRI 中接入本地 Index-TTS 语音合成服务启动、配置与源码解析在 AIRI 中接入本地 Index TTS 语音合成服务启动、配置与源码解析 Index TTSIndex TTS by Bilibili是 AIRI人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端AIRI 接入本地 Index-TTS自托管语音合成服务的完整配置指南AIRI 接入本地 Index TTS自托管语音合成服务的完整配置指南 本文以 AIRI 内置的 Bilibili / IndexTTS 提供者为主线讲解如人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务AIRI 接入 Player2 本地语音合成服务Base URL 配置、音色验证与模块启用全指南AIRI 接入 Player2 本地语音合成服务Base URL 配置、音色验证与模块启用全指南 Player2 Speech 是一款通过本地服务接入 AIR人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务上一篇JavaScript模块化开发终极指南从CommonJS到ES6模块的完整演进下一篇Android-DataBackup Root环境配置Magisk/KernelSU/APatch全支持创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考