AIRI 接入 Player2 本地语音合成服务Base URL 配置、音色验证与模块启用全指南【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airiPlayer2 Speech 是一款通过本地服务接入 AIRI 的语音合成Text-to-Speech选项只要你在本机或可信局域网内运行着 Player2 Speech 服务就可以把 AIRI 的语音能力完全交由该服务承担。读完本文你将掌握 Player2 服务的启动与健康检查、AIRI 侧 Base URL 的配置方法、音色列表的拉取与验证流程以及在“模块 → 语音合成”中真正启用 Player2 让日常 AI 回复开口说话的全部步骤。为什么选择 Player2官方文档对选用理由的说明很直接如果你已经在本地或可信的 LAN 上运行 Player2 Speech就可以让 AIRI 连接该服务并使用其提供的可用音色。这意味着语音合成请求和音频数据都停留在你自己的网络边界内适合对数据隐私与自托管有要求的部署场景。从源码角度可以看得更清楚在 player2-speech 提供者定义 中该提供者的tasks被标记为[text-to-speech]即纯文本转语音任务不涉及语音识别等其它能力其createProvider通过createPlayer2(normalizeBaseUrl(config.baseUrl), airi)建立与本地服务的连接第二个参数airi会作为请求头player2-game-key的取值发送详见下文健康检查一节。一、启动本地 Player2 服务按 Player2 官方部署方式启动服务并确认其健康检查端点health check可以正常响应。记录服务的完整 Base URLAIRI 默认连接http://localhost:4315/v1/。如果你的服务运行在其它地址或端口请务必把完整的 Base URL 记下来稍后填入 AIRI 设置。默认 Base URL 在源码中同样有据可查player2ConfigSchema中baseUrl的默认值即为http://localhost:4315/v1/见 提供者定义。::: warning 本地服务安全 不要把本地服务的端口暴露到不可信的公共网络上。若修改了监听地址请自行保护好服务访问权限。 :::二、在 AIRI 中配置 Player2打开设置 → 提供者 → 语音合成 → Player2。输入 Player2 服务的Base URL。这里有几个源码层面的细节值得展开Base URL 归一化normalizeBaseUrl会对输入做trim()处理并保证以/结尾——如果你填http://localhost:4315/v1实际请求会落到http://localhost:4315/v1/见 normalizeBaseUrl因此末尾斜杠写不写都不影响正确性。配置校验validationRequiredWhen仅在baseUrl非空时要求校验validateConfig会检查 Base URL 是否填写未填写时给出的提示信息即为默认地址http://localhost:4315/v1/。连通性校验validateProvider会对BaseURL/health发起 GET 请求并携带请求头player2-game-key: airi超时 5 秒后中止见 connectivity validator。这与页面加载时的逻辑一致在 player2-speech 设置页 中onMounted会请求BaseURL/health根据返回的 HTTP 状态码是否为 200 来切换页面上的错误告警hasPlayer2。如果校验失败页面会提示“下载并运行 Player2 App”player2.game并附上 Discord 支持入口——注意这是页面内嵌文案中的外部链接提示接入时以你自己的服务地址为准。三、在提供者播放器中验证在**提供者播放器playground**页面选择一个可用的音色。该页面使用 AIRI 内置的 Player2 默认模型v1进行合成。在播放器输入框中输入一小段文本点击合成并确认能听到音频播放。关于这一步的源码依据默认模型设置页中defaultModel v1实际合成时取配置中的model若为空则回退到v1见 player2-speech.vue。音色来源播放器使用的音色列表来自speechStore.availableVoices[player2-speech]它在提供者配置校验通过后通过loadVoicesForProvider拉取见 loadVoicesForProvider。而listVoices的实现会请求BaseURL/tts/voices从响应中的voices数组解析出id、name、gender与language字段见 listVoices。播放器默认文案播放器内置测试文本Hello! This is a test of the Player 2 voice synthesis.开箱即可试听。语速调节播放器还提供一个范围为0.5 ~ 5.0、步长0.01的语速滑杆调整后会实时写入providerConfig.speed见 speedRatio watch该数值随后会映射到 SSML 的prosody/rate参与合成见 generateSSML默认值为1.0。四、让 Player2 服务于 AIRI 的日常回复播放器测试只验证了“这条链路可用”它不会自动把 Player2 应用到 AIRI 的普通对话回复上。要正式启用请按以下步骤操作打开设置 → 模块 → 语音合成。选择Player2作为语音合成提供者。选择可用的模型与音色。这一步对应语音合成状态管理中的speech主流程packages/stage-ui/src/stores/modules/speech.ts在切换提供者时会调用loadVoicesForProvider拉取新提供者的音色列表见 speech.ts并在合成请求中透传providerConfig中的语速等参数最终把文本送入你配置的 Player2 服务。注意listModels只暴露一个默认模型player2-tts描述为 Default model for Player2 speech endpoint因此模块里的模型选择相对固定重点应放在音色选择上。五、问题排查官方文档给出了两条最直接的排查线索连接失败检查服务/health的响应情况并核对 Base URL 是否正确。这里可以复用前文提到的两点连通性校验要求/health返回 200 且响应在 5 秒超时内Base URL 必须指向包含/v1/前缀的完整地址默认http://localhost:4315/v1/。音色列表为空确认服务/tts/voices接口可以被访问。AIRI 侧的音色解析依赖该接口返回voices数组中的id/name/gender/language字段若接口不可达或返回结构不符播放器与模块中的音色列表都会是空的。此外可结合场景补充几点自查项服务是否确实在监听你所填的端口例如netstat/lsof确认 4315 端口;本机防火墙或反代是否拦截了对该端口的访问;页面上的健康检查请求会附带player2-game-key: airi请求头若你的 Player2 服务要求该密钥与配置一致请确保两者匹配默认即airi见 createPlayer2;若配置校验失败设置页会显示错误提示可据此判断是 Base URL 未填、服务不可达还是 HTTP 状态码异常。相关阅读Index-TTS本地 TTS接入指南同为本地语音合成服务模式与 Player2 高度相似可对照学习提供者定义与注册机制了解 AIRI 如何注册和管理各类语音提供者语音合成状态管理深入阅读loadVoicesForProvider、generateSSML与speech主流程语音合成相关测试通过测试用例验证音色加载与合成行为【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考