集成指南第三方软件接入
LibreChat 接入教程
在 librechat.yaml 中配置 Kitta AI OpenAI 兼容 TTS,让 LibreChat 使用指定克隆音色播放回复。
LibreChat 接入 Kitta AI TTS
LibreChat 可以在 librechat.yaml 中单独配置服务端 TTS。它的语音 Provider 与聊天模型 Provider 相互独立,因此不需要把 Kitta AI 添加为聊天模型端点。
准备工作
快速测试可以使用:
00a1b221-6137-4b73-ad62-b0cbce134167配置环境变量
在 LibreChat 的 .env 中添加:
FISH_AUDIO_API_KEY=YOUR_FISH_AUDIO_API_KEY不要把真实 Key 直接提交到 librechat.yaml 或 Git 仓库。
配置 librechat.yaml
把以下内容合并到现有的 speech 配置中,并将测试音色替换为自己的 Voice ID:
speech:
tts:
openai:
url: 'https://kittaai.com/v1/audio/speech'
apiKey: '${FISH_AUDIO_API_KEY}'
model: 'fishaudio-s21pro-flash'
voices:
- '00a1b221-6137-4b73-ad62-b0cbce134167'
speechTab:
textToSpeech:
engineTTS: 'external'
voice: '00a1b221-6137-4b73-ad62-b0cbce134167'
automaticPlayback: falseurl 是完整请求地址
LibreChat 的 speech.tts.openai.url 会被直接请求,因此必须包含 /audio/speech。这和要求只填写
Base URL 的软件不同。
如果需要多个音色,把 Voice ID 全部添加到 voices 数组。LibreChat 用户可以在语音设置中选择管理员允许的音色。
保存后重启 LibreChat:
docker compose restart进入 LibreChat 的语音设置,选择 External TTS 和刚配置的 Voice ID,然后播放一条短回复进行测试。
常见问题
- 没有 External TTS 选项:确认
speechTab.textToSpeech.engineTTS为external,并重启 LibreChat。 - 音色不在列表中:Voice ID 必须同时存在于
voices数组中;修改后重新加载配置。 - 404:
url必须是完整的https://kittaai.com/v1/audio/speech。 - 401:确认容器读取到了
FISH_AUDIO_API_KEY,并检查 Key 是否有效。 - 402:API 积分余额不足,需要补充积分。
- 400:不要使用
tts-1;模型必须填写fishaudio-s21pro-flash,音色必须填写 Voice ID。 - 聊天请求失败:不要把 Kitta AI URL 配置在 LibreChat 的聊天 Custom Endpoint 中;它只提供这里使用的 TTS 端点。