Richten Sie den Fish Audio-Anbieter in RikkaHub auf den kompatiblen /v1/tts-Endpunkt und setzen Sie Voice ID sowie Modell.

Fish Audio TTS mit RikkaHub verbinden

Wählen Sie in RikkaHub den Fish Audio-Sprachanbieter und richten Sie die API-Basis auf Fish Audio statt auf api.fish.audio. Konfigurieren Sie anschließend API-Schlüssel, Voice ID und Modell für /v1/tts.

Nach der Einrichtung verbrauchen RikkaHub-Sprachanfragen Ihr Fish Audio API-Guthaben und spielen Audio über die ausgewählte Sprach-ID ab.

Was Sie brauchen

Ein Fish Audio-Konto mit API-Guthaben;
Ein Schlüssel Fish Audio API;
Eine Fish Audio-Sprach-ID (reference_id);
RikkaHub mit verfügbarem Sprachanbieter Fish Audio.

Ein API-Schlüssel ist ein vertraulicher Berechtigungsnachweis. Teilen Sie es nicht im Chat, in Screenshots oder auf nicht vertrauenswürdigen Websites. Erstellen Sie einen dedizierten Schlüssel für RikkaHub, damit Sie ihn separat überwachen oder widerrufen können.

Schritt 1: Erstellen Sie einen Fish Audio API-Schlüssel

Melden Sie sich bei Fish Audio an, öffnen Sie die API-Verwaltung und erstellen Sie einen Schlüssel für RikkaHub. Kopieren und speichern Sie ihn sofort, da der vollständige Schlüssel nur einmal angezeigt werden darf.

Schritt 2: Finden Sie eine Sprach-ID

RikkaHub sendet die Sprach-ID als reference_id. Kopieren Sie eine aus Ihrer Fish Audio-Sprachliste oder fragen Sie die API ab:

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

Um die Verbindung sofort zu testen, beginnen Sie mit dieser Sprach-ID des öffentlichen Systems:

00a1b221-6137-4b73-ad62-b0cbce134167

Ersetzen Sie es durch Ihre bevorzugte Sprach-ID, nachdem RikkaHub Audio erfolgreich generieren und abspielen kann.

Modell und Stimme nicht verwechseln:

Der Modellheader wählt die TTS-Engine-Version aus;
reference_id wählt die Sprecherstimme aus.
Verfügbare Stimmen auflisten
Benutzerdefinierte Stimme erstellen

Schritt 3: Konfigurieren Sie den Fish Audio-Anbieter in RikkaHub

Öffnen Sie in RikkaHub die Anbietereinstellungen Fish Audio / TTS und geben Sie Folgendes ein:

RikkaHub-Einstellung	Wert
API Basis-/Endpunkt-Host	`https://fishaudio.org`
Vollständiger Endpunkt (falls erforderlich)	`https://fishaudio.org/v1/tts`
API Schlüssel	Ihr Fish Audio API Schlüssel
Modell	`s2.1-pro` oder `s2.1-pro-flash`
Stimme / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167` (nach dem Test ersetzen)
Formatieren	`mp3`

Verwenden Sie die Feldnamen, die Ihr RikkaHub-Build anzeigt. Der wichtige Teil ist, dass die Anfrage POST https://fishaudio.org/v1/tts erreicht mit:

Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/json

und einen JSON-Körper, der text und einen nicht leeren reference_id enthält.

Wenn RikkaHub https://api.fish.audio vorab ausfüllt, ersetzen Sie den Host durch https://fishaudio.org und behalten Sie /v1/tts bei.

Speichern Sie den Anbieter, generieren Sie einen kurzen Satz und bestätigen Sie, dass RikkaHub das zurückgegebene Audio abspielen kann.

Schritt 4: Weisen Sie die Stimme bei Bedarf zu

Wenn Sie mit RikkaHub eine Stimme pro Charakter, Chat oder Assistent auswählen können, fügen Sie dieselbe Fish Audio-Sprach-ID in dieses Feld ein. Sie können eine Anbieterkonfiguration wiederverwenden und nur reference_id pro Zeichen ändern.

API Guthabenverbrauch

RikkaHub ruft Fish Audio /v1/tts auf und verbraucht das separate API-Guthaben. Text-to-Speech beginnt bei 1 API Credit pro effektivem Zeichen, und einige Modelle wenden möglicherweise einen Multiplikator an.

Kaufen Sie Credits über API-Preise und sehen Sie sich den Saldo in der API-Verwaltung an. Erfolgreiche Antworten können X-OpenAPI-Credits-Used sein.

Fehlerbehebung und FAQ

RikkaHub meldet einen Verbindungsfehler

Bestätigen Sie, dass der Host https://fishaudio.org ist, entfernen Sie Leerzeichen aus dem Schlüssel API und stellen Sie sicher, dass das Konto noch über API-Guthaben verfügt. Geben Sie nicht Ihr Fish Audio-Kontopasswort ein.

Die Anfrage gibt 400 zurück und erwähnt `reference_id`

Fish Audio erfordert eine explizite Sprach-ID. Geben Sie einen gültigen reference_id ein; Der Server wählt nicht stillschweigend eine Standardstimme aus.

Die Anfrage gibt 401 zurück oder sagt, dass der API-Schlüssel ungültig ist

Kopieren Sie den Schlüssel Fish Audio API erneut. Wenn es widerrufen wurde, erstellen Sie einen neuen Schlüssel und ersetzen Sie die in RikkaHub gespeicherten Anmeldeinformationen.

Die Anfrage gibt 402 zurück oder sagt, dass der Kontostand nicht ausreicht

Ihr API-Guthaben ist zu niedrig. Mitgliedschaftsguthaben und API-Guthaben sind separate Guthaben. Kaufen Sie also API-Guthaben auf der API-Preisseite.

RikkaHub stellt eine Verbindung her, spielt aber kein Audio ab

Testen Sie zuerst mit mp3. Wenn der Client opus angefordert hat, greift Fish Audio auf mp3 zurück, damit gängige Android-Player die Antwort dekodieren können. Stellen Sie außerdem sicher, dass die Sprach-ID gültig ist und dass die Autoplay- oder Stummschaltungseinstellungen von RikkaHub die Wiedergabe nicht blockieren.

Welches Modell soll ich wählen?

Beginnen Sie mit s2.1-pro oder s2.1-pro-flash. Fish Audio ordnet diese fish.audio-Labels den passenden Engine-Modell-IDs zu. Native IDs wie fishaudio-s21pro-flash funktionieren auch im model-Header.

RikkaHub-Einrichtungsleitfaden