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

LibreChat 接入教程

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

LibreChat 接入 Kitta Audio TTS

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

准备工作

  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://fishaudio.org/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.engineTTS 为 external,并重启 LibreChat。
  • 音色不在列表中:Voice ID 必须同时存在于 voices 数组中;修改后重新加载配置。
  • 404:url 必须是完整的 https://fishaudio.org/v1/audio/speech。
  • 401:确认容器读取到了 FISH_AUDIO_API_KEY,并检查 Key 是否有效。
  • 402:API 积分余额不足,需要补充积分。
  • 400:不要使用 tts-1;模型必须填写 fishaudio-s21pro-flash,音色必须填写 Voice ID。
  • 聊天请求失败:不要把 Kitta Audio URL 配置在 LibreChat 的聊天 Custom Endpoint 中;它只提供这里使用的 TTS 端点。

相关文档