Fish Audio Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

OpenMAIC-Setup-Anleitung

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

Fish Audio TTS mit OpenMAIC verbinden

OpenMAIC unterstützt benutzerdefinierte OpenAI-kompatible TTS-Anbieter. Nach der Verbindung von Fish Audio 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
AnbieternameFish Audio
Basis-URLhttps://fishaudio.org/v1
API SchlüsselIhr Fish Audio 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 Fish Audio mit OpenMAIC-Umgebungsvariablen konfigurieren:

TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://fishaudio.org/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 Fish Audio-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 Fish Audio 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