Kitta Audio Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

Tavo-Setup-Anleitung

Konfigurieren Sie Kitta Audio als benutzerdefinierten OpenAI-kompatiblen TTS-Anbieter in Tavo und weisen Sie dann Ihren Charakteren Kitta Audio-Stimmen zu.

Verbinden Sie Kitta Audio TTS mit Tavo

In dieser Anleitung wird gezeigt, wie Sie Kitta Audio als benutzerdefinierten OpenAI-kompatiblen TTS-Anbieter in Tavo konfigurieren und einem Charakter eine Kitta Audio-Stimme zuweisen. Nach der Einrichtung kann Tavo Zeichennachrichten mit der von Ihnen ausgewählten Stimme vorlesen.

Was Sie brauchen

  1. Ein Kitta Audio-Konto mit API-Guthaben;
  2. Ein Schlüssel Kitta Audio API;
  3. Die Kitta Audio-Sprach-ID, die Sie verwenden möchten;
  4. Eine funktionierende Tavo-Installation.

Ein API-Schlüssel ist ein vertraulicher Berechtigungsnachweis. Senden Sie es nicht an andere Personen und fügen Sie es nicht in Chat-Nachrichten, öffentliche Screenshots oder nicht vertrauenswürdige Websites ein. Erstellen Sie einen dedizierten Schlüssel für Tavo, damit Sie ihn separat überwachen oder widerrufen können.

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

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

Schritt 2: Finden Sie eine Sprach-ID

Tavo benötigt eine Sprach-ID, um Sprache mit einer bestimmten Stimme zu synthetisieren. Kopieren Sie eine aus Ihrer Kitta Audio-Sprachliste oder fragen Sie die API ab:

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

00a1b221-6137-4b73-ad62-b0cbce134167

Verwenden Sie es für den ersten Verbindungstest und ersetzen Sie es dann durch Ihre bevorzugte Sprach-ID, nachdem Tavo erfolgreich Audio generieren und abspielen kann.

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

Verwechseln Sie die Felder Modell und Stimme nicht: Das Modell wählt die TTS-Engine aus, während die Sprach-ID den Klang des Lautsprechers auswählt.

Schritt 3: Fügen Sie eine Stimme API in Tavo hinzu

In Tavo geöffnet:

More → Voice & Image Generation → Voice API → New

Wählen Sie TTS Custom OpenAI Protocol Model und geben Sie dann Folgendes ein:

Tavo-EinstellungWert
API Basis-URLhttps://fishaudio.org/v1
API SchlüsselIhr Kitta Audio API Schlüssel
Modell-IDfishaudio-s21pro-flash
Sprach-ID00a1b221-6137-4b73-ad62-b0cbce134167 (nach dem Testen ersetzen)
Audioformatmp3

Die Basis-URL sollte bei /v1 enden. Hängen Sie /audio/speech nicht an. Tavo fügt den vollständigen /v1/audio/speech-Pfad hinzu, wenn es eine Anfrage sendet.

Speichern Sie den Anbieter. Wenn Tavo einen Verbindungstest anbietet, generieren Sie einen kurzen Satz und bestätigen Sie, dass der Ton abgespielt wird.

Schritt 4: Weisen Sie die Stimme einem Charakter zu

Nachdem Sie die Stimme API erstellt haben, öffnen Sie Tavos Charakter-Sprachbindungsbildschirm:

Character Voice Binding → Select Character → Select Your Voice API

Wenn Tavo nach einer Sprach-ID fragt, geben Sie dieselbe Kitta Audio Sprach-ID erneut ein. Speichern Sie die Bindung, kehren Sie zum Chat zurück, senden Sie eine kurze Nachricht und starten Sie die Sprachwiedergabe.

Sie können jedem Charakter eine andere Kitta Audio-Stimme zuweisen. Verwenden Sie die Anbietereinstellungen erneut und ändern Sie nur die Sprach-ID in jeder Zeichenbindung.

API Guthabenverbrauch

Tavo generiert Sprache über Kitta Audio /v1/audio/speech 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. Die tatsächlichen Anforderungskosten werden in X-OpenAPI-Credits-Used zurückgegeben.

Fehlerbehebung und FAQ

Tavo meldet einen Verbindungsfehler

Bestätigen Sie, dass die Basis-URL https://fishaudio.org/v1 lautet, 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 Kitta Audio-Kontopasswort ein.

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

Kopieren Sie den Schlüssel Kitta Audio API erneut. Wenn es widerrufen wurde, erstellen Sie einen neuen Schlüssel und ersetzen Sie die alten in Tavo 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.

Tavo stellt eine Verbindung her, spielt aber kein Audio ab

Stellen Sie sicher, dass das Zeichen an die Stimme API gebunden ist und dass die Sprach-ID gültig ist. Testen Sie zunächst einen kurzen Satz mit mp3 und überprüfen Sie dann Tavos Einstellungen für automatische Wiedergabe, Stummschaltung und Hintergrundwiedergabe.

Tavo sagt, das Modell oder die Stimme sei ungültig

Verwenden Sie fishaudio-s21pro-flash als Modell-ID und eine Kitta Audio-Sprach-ID als Stimme. OpenAI-Namen wie tts-1 und alloy werden nicht automatisch Kitta Audio-Modellen oder -Stimmen zugeordnet.

Kann jeder Charakter eine andere Stimme verwenden?

Ja. Geben Sie für jeden Charakter die passende Kitta Audio-Sprach-ID ein, um den Charakteren unterschiedliche Stimmen zu geben.

Verwandte Dokumentation