Kitta AI Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

LibreChat-Setup-Anleitung

Konfigurieren Sie Kitta AI als OpenAI-kompatiblen serverseitigen TTS-Anbieter in librechat.yaml und spielen Sie Antworten mit einer geklonten Stimme ab.

Kitta AI TTS mit LibreChat verbinden

LibreChat kann den serverseitigen TTS unabhängig in librechat.yaml konfigurieren. Sein Sprachanbieter ist von seinen Chat-Modellanbietern getrennt, daher sollte Kitta AI nicht als Chat-Endpunkt hinzugefügt werden.

Bevor Sie beginnen

  1. Erstellen Sie einen Schlüssel für diese Instanz in API-Verwaltung.
  2. Öffnen Sie Ihre geklonte Stimme und kopieren Sie ihre Sprach-ID.
  3. Bestätigen Sie, dass Ihr API-Guthaben ausreichend ist.

Für einen Schnelltest verwenden Sie:

00a1b221-6137-4b73-ad62-b0cbce134167

Konfigurieren Sie die Umgebungsvariable

Fügen Sie diese Variable zur .env-Datei von LibreChat hinzu:

FISH_AUDIO_API_KEY=YOUR_FISH_AUDIO_API_KEY

Übertragen Sie den echten Schlüssel nicht direkt in librechat.yaml oder Ihrem Git-Repository.

Konfigurieren Sie librechat.yaml

Führen Sie diese Konfiguration in das vorhandene speech-Objekt ein und ersetzen Sie die Teststimme durch Ihre eigene Sprach-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 is the complete request URL

LibreChat fordert speech.tts.openai.url direkt an, daher muss es /audio/speech enthalten. Das unterscheidet sich von Apps, die nur nach einer Basis-URL fragen.

Um mehrere Stimmen anzubieten, fügen Sie jede Sprach-ID zum voices-Array hinzu. LibreChat-Benutzer können zwischen den vom Administrator zugelassenen Stimmen wählen.

Starten Sie LibreChat neu, nachdem Sie die Konfiguration gespeichert haben:

docker compose restart

Öffnen Sie die Spracheinstellungen von LibreChat, wählen Sie „Extern TTS“ und die konfigurierte Sprach-ID aus und spielen Sie testweise eine kurze Antwort ab.

Fehlerbehebung

  • Externes TTS fehlt: Setzen Sie speechTab.textToSpeech.engineTTS auf external und starten Sie LibreChat neu.
  • Die Stimme fehlt: Die Sprach-ID muss auch im voices-Array erscheinen. Laden Sie die Konfiguration neu, nachdem Sie sie bearbeitet haben.
  • 404: url muss die vollständige https://kittaai.com/v1/audio/speech-URL sein.
  • 401: Überprüfen Sie, ob der Container FISH_AUDIO_API_KEY empfängt und dass der Schlüssel gültig ist.
  • 402: Fügen Sie API-Credits hinzu, bevor Sie es erneut versuchen.
  • 400: tts-1 nicht verwenden. Stellen Sie das Modell auf fishaudio-s21pro-flash ein und verwenden Sie eine gültige Sprach-ID.
  • Chat-Anfragen schlagen fehl: Fügen Sie die Kitta AI-URL nicht in einen benutzerdefinierten LibreChat-Chat-Endpunkt ein. In diesem Setup handelt es sich um einen Nur-TTS-Endpunkt.

Verwandte Dokumentation