AIRI 集成 OpenRouter 语音合成TTS从 API Key 申请到在线调试的完整配置指南【免费下载链接】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 的官方配置文档为主体结合仓库中 OpenRouter 语音合成 Provider 的真实实现Provider 定义 与 设置页面系统讲解如何在 AIRI 中把 OpenRouter 配置为语音合成服务提供者。读完本文你将掌握 OpenRouter API Key 的申请与安全保管方法、AIRI 设置界面中的完整配置步骤、模型与音色的选择逻辑以及通过内置测试与源码级排查手段定位不出声问题的能力。OpenRouter 与 AIRI 语音合成的关系OpenRouter 是一个将多家 AI 服务商 API 聚合在一起的统一服务提供者开发者只需一个 API Key 就能调用其生态内的多种模型。在 AIRI 中OpenRouter 对应两条 Provider 链路用于对话的openrouter-aichat与用于语音合成的openrouter-audio-speechtext-to-speech。本文聚焦后者。从 Provider 注册代码 可以看到该 Provider 的tasks被标记为[text-to-speech]说明它只承担 TTS 职责当你在设置中为语音合成模块选择 OpenRouter 后AIRI 会通过它生成可播放的音频。需要特别说明的是OpenRouter 语音模型的实际可用性可用模型、音色、付费方式取决于你的网络环境、账号所在地区、绑定的支付方式以及 OpenRouter 当前的平台策略并非所有模型对所有账号都开放。第一步申请 OpenRouter API Key配置前的准备工作是获取一个有效且安全的 API Key步骤如下打开 OpenRouter 的 API Keys 管理页面登录账号后创建新的 API Key创建时合理设置 Key 的名称、有效期与配额额度限制便于日后审计与回收生成后立即复制并保存到安全位置如密码管理器。⚠️API Key 安全警告切勿将 Key 提交到 Git 仓库、截入截图或分享给任何人。一旦怀疑泄露应立即在 OpenRouter 控制台作废旧 Key 并重新生成避免被他人盗刷调用额度。第二步在 AIRI 中配置 OpenRouter 语音提供者打开 AIRI 的设置 → 提供者 → 语音合成 → OpenRouter页面在基本设置中粘贴刚才申请的 API Key保持默认 Base URL 为https://openrouter.ai/api/v1/不变。这个默认地址与源码中的常量完全一致在 Provider 实现 中DEFAULT_BASE_URL https://openrouter.ai/api/v1/配置结构zod schema只包含两个字段必填的apiKey与带默认值的baseUrl。值得注意的是 normalizeBaseUrl 函数即使你把 Base URL 填成了不带尾部斜杠的形式它也会自动补上/保证后续拼接/chat/completions等路径时不会出错——所以日常使用中保持默认值即可。在设置页面的源码openrouter-audio-speech.vue中该提供者的 ID 为openrouter-audio-speech默认模型为openai/gpt-audio-mini。配置校验逻辑AIRI 会即时校验你的配置。从 validators 定义 看校验规则是只要apiKey非空去除首尾空白后配置即视为通过若为空则报错API Key is required.。这意味着粘贴 Key 后应立即能看到配置有效性反馈无需等到使用时才暴露问题。第三步选择模型与音色并测试配置好提供者后进入设置 → 模块 → 语音合成在语音合成模块中选择刚配置的提供者 OpenRouter选择模型。AIRI 会通过 listModels 请求https://openrouter.ai/api/v1/models?output_modalityaudio只拉取支持音频输出的模型源码中使用output_modalityaudio查询参数过滤并在设置页面的 Model 下拉框中列出默认选中openai/gpt-audio-mini选择音色。OpenRouter 语音沿用 OpenAI 兼容音色集源码中的openAIVoices常量index.ts内置了 13 个可选音色alloy、ash、ballad、coral、echo、fable、onyx、nova、sage、shimmer、verse、marin、cedar在界面中会以首字母大写形式展示如 Alloy、Ash在测试输入框中填写一段测试文本点击Test Voice按钮。测试按钮对应设置页面的 SpeechPlayground默认测试文本为Hello! This is a test of OpenRouter Speech.。若测试音频能正常播放说明提供者已正确连通若 AIRI 界面弹出错误则根据错误消息逐项排查凭证与模型设置。测试背后的请求链路点击测试后底层调用链是这样的页面 handleGenerateSpeech 获取 Provider 实例再交由 speech store 的 speech 方法 调用xsai/generate-speech生成音频。真正的请求由 createAudioFetch 发出请求地址为baseUrl/chat/completions即https://openrouter.ai/api/v1/chat/completions请求体携带model、构造好的提示词Read this text aloud exactly as written... 你的文本、modalities: [text, audio]、audio: { voice, format: pcm16 }以及stream: true响应是 SSE 流data:前缀行代码逐行解析choices[0].delta.audio.data中的 Base64 PCM 分片遇到[DONE]结束最后通过proj-airi/audio/encoding的toWavFromPCM16将 16-bit PCM 数据以24000 Hz采样率封装为 WAV返回给播放器。请求归属头Attribution HeadersAIRI 在向 OpenRouter 发请求时会额外携带 OPENROUTER_ATTRIBUTION_HEADERSHTTP-Referer: https://airi.moeru.ai/ X-OpenRouter-Title: Project AIRI这两个头用于向 OpenRouter 标识流量来源与项目名称对应其平台要求的归属机制在语音请求index.ts与模型列表请求同文件 L171中都会被自动注入无需手动配置。问题排查点击测试后没有声音按以下顺序逐项排查模型是否支持音频输出确认所选模型在 OpenRouter 上具备语音生成能力。模型下拉框仅展示带output_modalityaudio标记的模型但具体某个模型在账号环境下的可用性仍以 OpenRouter 平台为准账号余额登录 OpenRouter 控制台确认账号余额与配额充足语音生成通常按 token 计费余额不足会导致请求失败网络连通性确认本机可以正常访问https://openrouter.ai/api/v1/区域网络策略、代理设置都可能影响连通性API Key 有效性回到设置页确认 Key 已正确粘贴且配置校验通过无API Key is required.错误查看错误消息AIRI 会把请求失败时的 HTTP 状态码与服务端响应文本一并抛出源码中OpenRouter audio request failed: ${status} ${text}直接依据该消息定位是鉴权失败401/403、配额不足429还是模型不存在404。补充说明OpenRouter 在 AIRI 中的更多用途如果你已经在 AIRI 中配置了 OpenRouter 的聊天提供者openrouter-ai可以发现它与语音提供者共用同一套 Key 与 Base URL 约定聊天链路同样支持reasoning推理模式映射测试见 index.test.tsenabled → medium、disabled → none并复用相同的归属请求头。这意味着一份 OpenRouter 账号即可同时支撑对话与语音合成两条链路管理成本较低两者的可用性均受 OpenRouter 平台策略与账号环境约束。【免费下载链接】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），仅供参考 AIRI 集成 OpenRouter 语音合成（TTS）：从 API Key 申请到在线调试的完整配置指南
AIRI 集成 OpenRouter 语音合成TTS从 API Key 申请到在线调试的完整配置指南【免费下载链接】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 的官方配置文档为主体结合仓库中 OpenRouter 语音合成 Provider 的真实实现Provider 定义 与 设置页面系统讲解如何在 AIRI 中把 OpenRouter 配置为语音合成服务提供者。读完本文你将掌握 OpenRouter API Key 的申请与安全保管方法、AIRI 设置界面中的完整配置步骤、模型与音色的选择逻辑以及通过内置测试与源码级排查手段定位不出声问题的能力。OpenRouter 与 AIRI 语音合成的关系OpenRouter 是一个将多家 AI 服务商 API 聚合在一起的统一服务提供者开发者只需一个 API Key 就能调用其生态内的多种模型。在 AIRI 中OpenRouter 对应两条 Provider 链路用于对话的openrouter-aichat与用于语音合成的openrouter-audio-speechtext-to-speech。本文聚焦后者。从 Provider 注册代码 可以看到该 Provider 的tasks被标记为[text-to-speech]说明它只承担 TTS 职责当你在设置中为语音合成模块选择 OpenRouter 后AIRI 会通过它生成可播放的音频。需要特别说明的是OpenRouter 语音模型的实际可用性可用模型、音色、付费方式取决于你的网络环境、账号所在地区、绑定的支付方式以及 OpenRouter 当前的平台策略并非所有模型对所有账号都开放。第一步申请 OpenRouter API Key配置前的准备工作是获取一个有效且安全的 API Key步骤如下打开 OpenRouter 的 API Keys 管理页面登录账号后创建新的 API Key创建时合理设置 Key 的名称、有效期与配额额度限制便于日后审计与回收生成后立即复制并保存到安全位置如密码管理器。⚠️API Key 安全警告切勿将 Key 提交到 Git 仓库、截入截图或分享给任何人。一旦怀疑泄露应立即在 OpenRouter 控制台作废旧 Key 并重新生成避免被他人盗刷调用额度。第二步在 AIRI 中配置 OpenRouter 语音提供者打开 AIRI 的设置 → 提供者 → 语音合成 → OpenRouter页面在基本设置中粘贴刚才申请的 API Key保持默认 Base URL 为https://openrouter.ai/api/v1/不变。这个默认地址与源码中的常量完全一致在 Provider 实现 中DEFAULT_BASE_URL https://openrouter.ai/api/v1/配置结构zod schema只包含两个字段必填的apiKey与带默认值的baseUrl。值得注意的是 normalizeBaseUrl 函数即使你把 Base URL 填成了不带尾部斜杠的形式它也会自动补上/保证后续拼接/chat/completions等路径时不会出错——所以日常使用中保持默认值即可。在设置页面的源码openrouter-audio-speech.vue中该提供者的 ID 为openrouter-audio-speech默认模型为openai/gpt-audio-mini。配置校验逻辑AIRI 会即时校验你的配置。从 validators 定义 看校验规则是只要apiKey非空去除首尾空白后配置即视为通过若为空则报错API Key is required.。这意味着粘贴 Key 后应立即能看到配置有效性反馈无需等到使用时才暴露问题。第三步选择模型与音色并测试配置好提供者后进入设置 → 模块 → 语音合成在语音合成模块中选择刚配置的提供者 OpenRouter选择模型。AIRI 会通过 listModels 请求https://openrouter.ai/api/v1/models?output_modalityaudio只拉取支持音频输出的模型源码中使用output_modalityaudio查询参数过滤并在设置页面的 Model 下拉框中列出默认选中openai/gpt-audio-mini选择音色。OpenRouter 语音沿用 OpenAI 兼容音色集源码中的openAIVoices常量index.ts内置了 13 个可选音色alloy、ash、ballad、coral、echo、fable、onyx、nova、sage、shimmer、verse、marin、cedar在界面中会以首字母大写形式展示如 Alloy、Ash在测试输入框中填写一段测试文本点击Test Voice按钮。测试按钮对应设置页面的 SpeechPlayground默认测试文本为Hello! This is a test of OpenRouter Speech.。若测试音频能正常播放说明提供者已正确连通若 AIRI 界面弹出错误则根据错误消息逐项排查凭证与模型设置。测试背后的请求链路点击测试后底层调用链是这样的页面 handleGenerateSpeech 获取 Provider 实例再交由 speech store 的 speech 方法 调用xsai/generate-speech生成音频。真正的请求由 createAudioFetch 发出请求地址为baseUrl/chat/completions即https://openrouter.ai/api/v1/chat/completions请求体携带model、构造好的提示词Read this text aloud exactly as written... 你的文本、modalities: [text, audio]、audio: { voice, format: pcm16 }以及stream: true响应是 SSE 流data:前缀行代码逐行解析choices[0].delta.audio.data中的 Base64 PCM 分片遇到[DONE]结束最后通过proj-airi/audio/encoding的toWavFromPCM16将 16-bit PCM 数据以24000 Hz采样率封装为 WAV返回给播放器。请求归属头Attribution HeadersAIRI 在向 OpenRouter 发请求时会额外携带 OPENROUTER_ATTRIBUTION_HEADERSHTTP-Referer: https://airi.moeru.ai/ X-OpenRouter-Title: Project AIRI这两个头用于向 OpenRouter 标识流量来源与项目名称对应其平台要求的归属机制在语音请求index.ts与模型列表请求同文件 L171中都会被自动注入无需手动配置。问题排查点击测试后没有声音按以下顺序逐项排查模型是否支持音频输出确认所选模型在 OpenRouter 上具备语音生成能力。模型下拉框仅展示带output_modalityaudio标记的模型但具体某个模型在账号环境下的可用性仍以 OpenRouter 平台为准账号余额登录 OpenRouter 控制台确认账号余额与配额充足语音生成通常按 token 计费余额不足会导致请求失败网络连通性确认本机可以正常访问https://openrouter.ai/api/v1/区域网络策略、代理设置都可能影响连通性API Key 有效性回到设置页确认 Key 已正确粘贴且配置校验通过无API Key is required.错误查看错误消息AIRI 会把请求失败时的 HTTP 状态码与服务端响应文本一并抛出源码中OpenRouter audio request failed: ${status} ${text}直接依据该消息定位是鉴权失败401/403、配额不足429还是模型不存在404。补充说明OpenRouter 在 AIRI 中的更多用途如果你已经在 AIRI 中配置了 OpenRouter 的聊天提供者openrouter-ai可以发现它与语音提供者共用同一套 Key 与 Base URL 约定聊天链路同样支持reasoning推理模式映射测试见 index.test.tsenabled → medium、disabled → none并复用相同的归属请求头。这意味着一份 OpenRouter 账号即可同时支撑对话与语音合成两条链路管理成本较低两者的可用性均受 OpenRouter 平台策略与账号环境约束。【免费下载链接】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），仅供参考