Kitta AI Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

OpenMAIC-Setup-Anleitung

Fügen Sie Kitta AI als benutzerdefinierten OpenAI-kompatiblen TTS-Anbieter in OpenMAIC für KI-Lehrer, Klassenkameraden und Kurskommentare hinzu.

Kitta AI TTS mit OpenMAIC verbinden

OpenMAIC unterstützt benutzerdefinierte OpenAI-kompatible TTS-Anbieter. Nach der Verbindung von Kitta AI können KI-Lehrer, Klassenkameraden, Kurskommentare und generierte Inhalte Ihre ausgewählte Stimme verwenden.

Bereiten Sie einen API-Schlüssel und eine Sprach-ID vor

  1. Erstellen Sie einen dedizierten Schlüssel 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

Fügen Sie in den Einstellungen einen benutzerdefinierten Anbieter hinzu

Öffnen Sie Settings → TTS und fügen Sie einen benutzerdefinierten OpenAI-kompatiblen TTS-Anbieter hinzu. Eingeben:

OpenMAIC-EinstellungWert
AnbieternameKitta AI
Basis-URLhttps://kittaai.com/v1
API SchlüsselIhr Kitta AI API Schlüssel
Modellfishaudio-s21pro-flash
Sprach-IDDie Sprach-ID Ihrer geklonten Stimme
SprachnameBeliebiger Anzeigename

OpenMAIC hängt /audio/speech an die Basis-URL an und sendet die endgültige Anfrage an POST /v1/audio/speech. Geben Sie nicht den vollständigen Endpunkt in das Feld „Basis-URL“ ein.

Nachdem Sie die Stimme hinzugefügt haben, machen Sie diese zum aktiven TTS-Anbieter und wählen Sie die neue Sprach-ID aus. Verwenden Sie die Testtaste TTS mit einem kurzen Satz, um die Stimme und Authentifizierung zu überprüfen.

Prefer server-side keys for shared deployments

OpenMAIC kann benutzerdefinierte Anbieter in den Client-Einstellungen speichern. Geben Sie dort nur auf einem vertrauenswürdigen Server einen API-Schlüssel ein selbstgehostete Instanz. Für öffentliche oder Mehrbenutzerbereitstellungen sollten Administratoren TTS konfigurieren serverseitig, sodass der Schlüssel den Browserbenutzern nicht zugänglich gemacht wird.

Serverseitige Konfiguration

Selbstgehostete Administratoren können Kitta AI mit OpenMAIC-Umgebungsvariablen konfigurieren:

TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1

Starten Sie OpenMAIC neu, nachdem Sie die Umgebung geändert haben. Wählen Sie dann in den TTS-Einstellungen den OpenAI-Anbieter aus und ersetzen Sie das Modell und die Stimme durch die Kitta AI-Modell-ID und die Sprach-ID.

Fehlerbehebung

  • 404: Die Basis-URL muss bei /v1 enden. Geben Sie nicht /v1/audio/speech ein, da sonst der Pfad dupliziert werden kann.
  • 401: Überprüfen Sie den API-Schlüssel des aktiven Anbieters. Starten Sie OpenMAIC neu, nachdem Sie einen serverseitigen Schlüssel geändert haben.
  • 402: Fügen Sie API-Credits hinzu, bevor Sie es erneut versuchen.
  • 400: Verwenden Sie fishaudio-s21pro-flash als Modell und eine gültige Sprach-ID.
  • Der Test funktioniert, aber das Klassenzimmer ist still: Machen Sie Kitta AI zum aktiven Anbieter und weisen Sie seine Stimme der Erzählerrolle zu.
  • Browser CORS oder Hauptprobleme: Verwenden Sie die serverseitige TTS-Konfiguration von OpenMAIC für eine gemeinsame Bereitstellung.

Verwandte Dokumentation