AIRI 接入 Volcano Engine TTSAPI Key、App ID 与 UnSpeech 网关配置指南【免费下载链接】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要在 AIRI 中启用火山引擎Volcano Engine语音合成核心是两样东西火山引擎控制台的App ID与API Key以及一个指向 UnSpeech 兼容网关的Base URL。读完本篇你将掌握从火山引擎控制台获取凭证、在 AIRI 设置页完成配置、通过提供商标题Playground验证合成效果到最终让 AIRI 的常规回复“开口说话”的完整链路并了解其底层配置校验逻辑与常见问题排查方法。为什么选择 Volcengine如果你已经在火山引擎上创建过语音应用、管理过语音资源那么这些既有配置可以直接复用到 AIRI 中——AIRI 的 Volcengine 语音合成提供方就是围绕“App ID API Key 兼容网关”这一组合设计的不需要为 AIRI 单独申请新的语音资源。准备应用凭证在配置 AIRI 之前先在火山引擎侧准备好凭证登录 Volcengine Speech 控制台新建一个语音应用或打开一个已有的语音应用复制该应用的App ID并为该应用生成API Key确认这两个凭证来自同一个账号、同一个应用的配置——AIRI 侧的校验逻辑下文会展开只验证格式无法替你发现“跨应用混填”的问题这一步必须人工确认。API Key 安全不要把 API Key 或 App ID 提交进代码仓库、贴进截图或分享给任何人。一旦泄露应立即在火山引擎控制台废弃旧密钥并重新生成。AIRI 中的 Volcengine 提供方配置结构与校验逻辑要理解设置页上每个字段的含义值得看一下 AIRI 中该提供方的定义位于 providerVolcengineSpeech 定义。配置项Zod Schema该提供方的配置由一个通用 UnSpeech 配置加上 Volcengine 专属字段扩展而来配置 Schema字段类型必填默认值 / 说明apiKeystring是火山引擎 API Key表单中以密码类型type: password输入baseUrlstring是默认https://unspeech.hyp3r.link/v1/即 AIRI/UnSpeech 网关地址app.appIdstring是火山引擎应用的 App ID仅此提供方额外要求校验规则保存配置时AIRI 会执行 validateUnspeechConfig 校验器对 Volcengine 开启了requireAppId规则包括apiKey不能为空API key is required.baseUrl不能为空且必须是绝对 URL包含http://或https://协议baseUrl必须以/结尾Base URL must end with a trailing slash (/).——这是 UnSpeech 兼容网关的要求改用自己的自托管网关时尤其容易踩坑Volcengine 额外要求app.appId非空App ID is required.。另外validationRequiredWhen 表明只有当apiKey、baseUrl、app.appId三者都已填写时才会触发上述校验流程。模型与音色目录该提供方目前只暴露一个模型v1见 listModels设置页也以v1作为 defaultModel音色列表通过 UnSpeech 的listVoices能力远程拉取返回的每个音色带有id、name、previewURL试听音频、languages支持语言与gender性别标签等字段。在 AIRI 中配置打开设置 → 提供商标题Providers→ 语音合成 → Volcano Engine对应页面实现是 volcengine.vue。页面上除通用的 API Key、Base URL 字段外还有一个必填的App ID输入项basic-settings 插槽其标签文案定义在 ko 语言包 中填入 API Key 与 App ID。Base URL 默认值是https://unspeech.hyp3r.link/v1/这是 AIRI/UnSpeech 网关而不是火山引擎的直接 API。你的凭证、待合成文本、模型/音色选择以及返回的音频都会经过该网关。请明确评估这一信任边界只有在你能接受的前提下才使用默认网关否则应填入你自己托管的兼容网关 URL注意保持以/结尾或改用其他直连提供方。页面上还有一个语速Speed滑杆取值范围0.5 ~ 2.0步长 0.01写入配置的audio.speedRatio字段speedRatio 逻辑。配置确认Playground 验证配置页加载时会自动执行一次校验校验通过后才拉取音色列表onMounted 与 watch 逻辑。确认步骤在提供方 Playground 中选择可用音色——此页使用的是 AIRI 默认的 Volcengine 语音合成模型v1在 Playground 输入一段短文本确认能成功合成并播放音频。在 AIRI 响应中启用语音注意一个关键区别提供方 Playground 只用于测试凭证是否有效它并不会改变 AIRI 的默认语音输出。要真正让 AIRI 的常规回复用 Volcano Engine 发声还需要打开设置 → 模块Modules→ 语音合成选择Volcano Engine作为当前语音合成提供方选择可用的模型与音色。问题排查校验/合成确认失败优先检查 App ID 与 API Key 是否确实来自同一个火山引擎应用跨应用混填是最常见原因AIRI 的格式校验无法发现此类错误有请求但不出声确认“设置 → 模块 → 语音合成”中确实启用了 Volcano Engine 提供方并选择了音色——Playground 能出声不代表模块层已启用使用自托管网关时校验报错检查 Base URL 是否以/结尾、是否包含完整协议前缀。延伸阅读与官方语音提供方的关系AIRI 还内置了“Official Speech Provider”登录账号即可用、无需自备凭证它走服务端/api/v1/audio/...代理实现见 providerOfficialSpeech。Volcengine 提供方与官方提供方是并列的两条 TTS 路径前者让你复用自己在火山引擎上的语音应用与音色资产走 UnSpeech 网关后者由服务端统一路由。二者可在“设置 → 模块 → 语音合成”中按场景切换。【免费下载链接】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），仅供参考