人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载AIRI 支持将 OpenRouter 作为语音合成Text-to-Speech服务商让你在同一个 OpenRouter 账户下统一管理音频模型与音色。本文基于 openrouter.md韩文版英文版见 openrouter.md简体中文版见 openrouter.md并结合仓库源码说明配置项背后的实现细节。读完本文你将掌握如何申请 API Key、如何在 AIRI 设置界面完成配置、如何通过「发声」模块选择模型与音色并做发声测试以及无声音等常见问题的排查思路。为什么选择 OpenRouter 语音OpenRouter 本身是一个聚合式 API 服务商它把多家上游模型提供商的接口统一收敛到一套 OpenAI 兼容协议之下。在 AIRI 的语音合成场景中选择 OpenRouter 意味着可以在同一个 OpenRouter 账户里集中管理多个音频模型和音色而不必为每家上游分别申请密钥实际可用性网络环境、支付方式、服务商政策因用户所在地区而异例如简体中文文档提示中国大陆用户可优先尝试 302.AI 等替代聚合渠道。这一点在源码中也有体现AIRI 的 provider 注册表里同时存在openrouter-ai对话/chat 任务与openrouter-audio-speech文本转语音任务两个条目其中 openrouter-audio-speech/index.ts 正是本文主角——语音合成提供商的完整实现。第一步获取 OpenRouter API Key在开始配置前需要先在 OpenRouter 控制台创建密钥打开 OpenRouter 的 API Keys 页面创建一个新的 API Key。为密钥设置适当的名称、有效期和额度限制便于后续管理和控制成本。复制密钥并妥善保存配置时粘贴到 AIRI 中。API Key 安全警告不要将 API Key 提交到仓库、放入截图或发送给他人。一旦密钥泄露请立即在 OpenRouter 控制台撤销它并创建新密钥。从源码实现看API Key 是 OpenRouter 语音提供商的必填项配置 Schema 定义为apiKey: z.string()且校验器在apiKey为空时直接判定配置无效提示API Key is required.对应 openrouter-audio-speech/index.ts。第二步在 AIRI 中配置 OpenRouter配置路径为设置 → 服务商 → 语音合成 → OpenRouter对应仓库中的设置页面 openrouter-audio-speech.vue该页面由SpeechProviderSettings骨架与两个自定义插槽voice-settings模型选择、playground发声实验台构成。需要填写的基础配置只有两项配置项说明默认值API Key第一步申请的 OpenRouter 密钥必填无Base URLAPI 端点地址一般保持默认即可https://openrouter.ai/api/v1/在源码中Base URL 的默认值与归一化逻辑非常清晰默认地址常量定义为https://openrouter.ai/api/v1/见 openrouter-audio-speech/index.ts若用户清空了 Base URL会回退到默认值若用户输入的值末尾缺少/会自动补上保证拼接请求路径时格式正确normalizeBaseUrl见 openrouter-audio-speech/index.ts。因此保留默认 Base URL是最稳妥的做法只有当你自建 OpenRouter 兼容代理或网关时才需要改动它。第三步验证配置并测试发声配置完成后进入设置 → 模块 → 发声不同语言文档中亦有“语音合成”的表述选择刚才配置的OpenRouter服务商并选择要使用的模型与音色。输入一段测试文本点击测试声音Test Voice按钮。若能正常播放生成的语音说明配置成功若显示错误请根据错误信息检查凭据与模型。模型选择OpenRouter 语音提供商默认使用openai/gpt-audio-mini模型见 openrouter-audio-speech/index.ts设置页面同样以该值作为兜底默认见 openrouter-audio-speech.vue。页面上方的模型下拉框数据来自listModels扩展方法AIRI 会请求 OpenRouter 的models?output_modalityaudio端点只拉取支持音频输出的模型并自动过滤掉不可用的条目请求失败时则返回空列表见 openrouter-audio-speech/index.ts。页面挂载时会自动加载已配置服务商的模型列表与音色列表openrouter-audio-speech.vue。音色选择音色列表来自内置的 OpenAI 风格声线集合共 13 个涵盖alloy、ash、ballad、coral、echo、fable、onyx、nova、sage、shimmer、verse、marin、cedar见 openrouter-audio-speech/index.ts。也就是说只要上游模型支持 OpenAI 兼容的voice参数这些声线即可直接选用。源码视角一次发声请求在 AIRI 内部如何流转为了让你更清楚地理解“点了测试按钮之后发生了什么”这里结合源码还原完整调用链设置页的handleGenerateSpeech从 provider 实例化管道取出SpeechProvider拿到用户输入的文本、所选音色和模型见 openrouter-audio-speech.vue。真正的请求封装在createAudioFetch中openrouter-audio-speech/index.ts向{baseUrl}chat/completions发起 POST 请求携带Authorization: Bearer apiKey附带OpenRouter 归属信息头HTTP-Referer: https://airi.moeru.ai/与X-OpenRouter-Title: Project AIRI这两个头定义于 openrouter-ai/index.ts以满足 OpenRouter 对来源标注的要求请求体把测试文本包装成Read this text aloud exactly as written...的朗读提示词并声明modalities: [text, audio]、audio: { voice, format: pcm16 }、stream: true。响应处理上AIRI 以流式方式逐行解析 SSE 事件以data:开头、遇[DONE]结束从choices[0].delta.audio.data中提取 base64 编码的 PCM16 音频分片openrouter-audio-speech/index.ts。所有分片拼接解码后调用toWavFromPCM16(bytes, 24000)以24 kHz 采样率封装成标准 WAV 文件再以audio/wav类型返回给播放器openrouter-audio-speech/index.ts。WAV 封装本身位于 wav.ts并有对应的 wav.test.ts 测试用例覆盖。说明OpenRouter 语音提供商在 provider 定义中被标记为paidCloud类见 attributes.ts即按使用量计费的云服务因此账户余额不足会直接导致请求失败——这也是下方排查清单中要重点检查的原因。常见问题排查当点击测试后没有声音时按以下顺序排查所选模型是否支持音频输出OpenRouter 上并非所有模型都支持语音模态。AIRI 的模型下拉框已通过output_modalityaudio过滤但若你手动填写了不支持的模型 ID则不会有音频返回。账户余额与额度paidCloud类服务按量计费余额不足时请求会报错请到 OpenRouter 控制台检查账户余额与密钥的额度限制。网络连接OpenRouter 为境外聚合服务请确认网络环境可正常访问https://openrouter.ai/api/v1/。凭据有效性若错误信息提示鉴权失败请重新检查 API Key 是否粘贴完整、是否已过期或被撤销必要时在 OpenRouter 控制台新建密钥后重新配置。小结OpenRouter 为 AIRI 提供了一条“一个账户、多模型多音色”的语音合成路径。核心配置仅需 API Key 与默认 Base URL 两项随后即可在“发声”模块中自由切换音频模型与 13 种内置声线。结合源码可以看到AIRI 对 OpenRouter 的接入完全复用 OpenAI 兼容的chat/completions音频流协议并在本地完成 PCM16 → WAV 的转封装实现链路清晰、可排查性良好。若你所在网络环境访问 OpenRouter 不稳定也可以参考 语音合成服务商文档目录 中的其他提供商方案。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐AIRI 集成 ElevenLabs 语音合成TTS完整指南从 API Key 配置到模型、音色与 SSML 调优AIRI 集成 ElevenLabs 语音合成TTS完整指南从 API Key 配置到模型、音色与 SSML 调优 本篇指南以 docs/content/人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端trackerslist 完整指南77 个公共 Tracker 节点怎么挑、怎么装进 qBittorrenttrackerslist 完整指南77 个公共 Tracker 节点怎么挑、怎么装进 qBittorrent trackerslist 是一个每天自动巡检的公AIRI 接入 OpenAI 兼容 TTS从 API Key 配置到音色调试的完整指南AIRI 接入 OpenAI 兼容 TTS从 API Key 配置到音色调试的完整指南 AIRI 是一款自托管、归你拥有的 Grok 风格 AI 伴侣应用语人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇告别图片混乱AntiDupl开源工具助你高效清理重复照片下一篇Spyder宏录制终极指南3倍提升Python开发效率的秘诀创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考