Kitta AI 文档
集成指南第三方软件接入

LibreChat 接入教程

在 librechat.yaml 中配置 Kitta AI OpenAI 兼容 TTS,让 LibreChat 使用指定克隆音色播放回复。

LibreChat 接入 Kitta AI TTS

LibreChat 可以在 librechat.yaml 中单独配置服务端 TTS。它的语音 Provider 与聊天模型 Provider 相互独立,因此不需要把 Kitta AI 添加为聊天模型端点。

准备工作

  1. API 管理页面创建该实例专用的 API Key。
  2. 打开自己的克隆音色,复制 Voice ID。
  3. 确认 API 积分余额充足。

快速测试可以使用:

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: false

url 是完整请求地址

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.engineTTSexternal,并重启 LibreChat。
  • 音色不在列表中:Voice ID 必须同时存在于 voices 数组中;修改后重新加载配置。
  • 404url 必须是完整的 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 端点。

相关文档