TTS 没声音、识别没文字:语音问题对照排查
语音问题分两条独立的链路:她说话(TTS)和她听话(STT)。配错对方不影响自己——先分清是哪条链路坏了,再对症下药。
她有文字但不说话(TTS 链路)
官方音频文档给出的排查顺序:
- 服务商、模型、音色三样都选了吗:发声页三处缺一不可,尤其音色要先选模型才出现。
- 系统输出设备与音量:播放设备选错、静音,是「配置全对却没声」的常见原因。
- 测试区报服务商错误:回服务商页检查 API Key、余额、该模型是否支持语音合成。
中文用户专属:内置 Kokoro 不支持中文,没换来源之前中文必然无声——解法见中文语音方案。
她听不见你说话(STT 链路)
官方顺序同样明确:
- 麦克风权限:macOS 首次要授权;Windows 看系统隐私设置;网页版看浏览器地址栏权限。
- 输入设备:听觉页与对话界面的麦克风图标里选对正在用的设备。
- 实时识别服务:网络中断或浏览器/系统的麦克风权限被撤销都会导致结果为空。
- 语言匹配:识别服务的语言、区域、模型设置必须与服务商实际开通的能力一致——识别语言选错会「听而不懂」。
链路自测工具见麦克风权限与收音测试。
特殊情况
- 她说话时你插不上话:AIRI 说话时会暂停收音防自问自答,这是设计行为。
- 朗读中途想闭麦:聊天窗口的「停止朗读」只停播放不影响文字,见聊天窗口。