Fish Audio Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

RimTalk TTS einrichten

Füge Fish Audio als OpenAI-kompatiblen Anbieter in RimTalk TTS hinzu und weise RimWorld-Kolonisten unterschiedliche Stimmen zu.

Fish Audio TTS mit RimTalk verbinden

RimTalk TTS kann Fish Audio über einen benutzerdefinierten OpenAI-kompatiblen Anbieter aufrufen und den Dialog jedes Kolonisten mit einer zugewiesenen Stimme vorlesen.

Zuerst die RimTalk-Version prüfen

Die Einstellungen müssen Custom TTS Providers (Untested!) und die Schaltfläche zum Hinzufügen eines Anbieters anzeigen. Diese Funktion gehört derzeit zur Entwicklungsversion des Projekts. Fehlen die Optionen, prüfe zuerst Quelle und Version der Mod.

Vorbereitung

Erstelle einen eigenen API-Schlüssel für RimTalk und besorge eine Fish Audio Voice ID. Veröffentliche den vollständigen Schlüssel niemals in Screenshots, Chats oder Mod-Dateien. Ein bereits offengelegter Schlüssel muss sofort widerrufen werden.

Für den ersten Verbindungstest steht diese Systemstimme bereit:

00a1b221-6137-4b73-ad62-b0cbce134167

Anbieter hinzufügen

Öffne TTS Configuration → Custom TTS Providers → Add New Custom Provider und trage Folgendes ein:

FeldWert
Provider nameFish Audio
Base URLhttps://fishaudio.org/v1
Endpoint path/audio/speech
Modelfishaudio-s21pro-flash
Default voice00a1b221-6137-4b73-ad62-b0cbce134167
Response formatmp3
Auth header nameAuthorization
Auth header prefixBearer mit einem nachfolgenden Leerzeichen
Timeout60 Sekunden

Die vollständige URL muss https://fishaudio.org/v1/audio/speech lauten. Aktiviere speed und lasse streaming, temperature, top_p, Emotionsfelder und benutzerdefinierten Request-Body ausgeschaltet.

Verwende nicht tts-1, alloy oder den alten Wert s2.1-pro. Das Engine-Modell und die Stimmen-UUID sind getrennte Felder.

Stimmen zuweisen

Speichere und wähle den neuen Anbieter. Füge in der Stimmenmodell-Liste einen verständlichen Namen hinzu und setze die Fish Audio Stimmen-UUID als Model ID ein. Wähle eine Standardstimme und ordne anschließend jedem Pawn eine Stimme zu.

Test und Fehlerbehebung

Beginne mit einem kurzen Satz eines einzelnen Kolonisten. Prüfe HTTP 200, die vollständige MP3-Wiedergabe und die Nutzung in der API-Verwaltung.

  • 401: Schlüssel und Leerzeichen nach Bearer prüfen.
  • 402: API-Guthaben aufladen.
  • 404: Base URL endet bei /v1, der Pfad lautet nur /audio/speech.
  • 400: Modell und Stimmen-UUID prüfen.
  • Zeitüberschreitung: Flash-Modell, 60 Sekunden und kurzen Text verwenden.
  • 429: Generierungspause beibehalten und gleichzeitige Anfragen reduzieren.

RimTalk wartet auf eine synchrone Audioantwort und fragt keine asynchronen Jobs ab. Zu lange Eingaben sollten gekürzt werden.

Weitere Dokumentation