Kitta AI Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

Android Custom TTS Setup-Anleitung

Verbinden Sie den benutzerdefinierten TTS-Dienst für Android mit Kitta AI und verwenden Sie eine geklonte Stimme in Apps, die die TTS-Engine des Android-Systems unterstützen.

Verwenden Sie Kitta AI als Android-System-TTS-Engine

Benutzerdefinierter TTS-Dienst für Android verbindet einen OpenAI-kompatiblen Sprachendpunkt mit der Text-zu-Sprache-Systemschnittstelle von Android. Apps, die die ausgewählte Android TTS-Engine verwenden, können dann Text mit einer Kitta AI-Stimme lesen.

System TTS boundary

Dies funktioniert nur in Android-Apps, die die TTS-Engine des Betriebssystems verwenden. Eine App mit eigener Der integrierte Sprachanbieter ignoriert möglicherweise die Android-Systemauswahl.

Bereiten Sie den API-Schlüssel und die Sprach-ID vor

  1. Erstellen Sie einen dedizierten Schlüssel in API-Verwaltung.
  2. Kopieren Sie die Sprach-ID Ihrer geklonten Stimme.
  3. Bestätigen Sie, dass Ihr API-Guthaben ausreichend ist.

Nutzen Sie für den ersten Test diese Systemstimme:

00a1b221-6137-4b73-ad62-b0cbce134167

Installieren und konfigurieren Sie die Engine

Installieren Sie die APK von der Veröffentlichungsseite des Projekts, öffnen Sie die App und geben Sie Folgendes ein:

EinstellungWert
Backend-URLhttps://kittaai.com/v1/audio/speech
API SchlüsselIhr Kitta AI API Schlüssel
TTS-Modellfishaudio-s21pro-flash
TTS Stimme00a1b221-6137-4b73-ad62-b0cbce134167
Antwortformatwav

Use the complete endpoint and WAV

Der Android-Dienst postet direkt an die Backend-URL, also /audio/speech einschließen. Die aktuelle Version unterstützt WAV- und PCM-Wiedergabe, dekodiert jedoch noch nicht MP3 oder Opus; Verwenden Sie wav für Kitta AI.

Tippen Sie auf Speichern, dann auf Android TTS-Einstellungen öffnen und wählen Sie Benutzerdefiniertes TTS als bevorzugte Engine aus. Verwenden Sie die Beispielwiedergabe von Android oder die Vorlesetaste einer App, um einen kurzen Satz zu testen.

Sicherheits- und Sprachnotizen

  • Der Schlüssel API ist auf dem Android-Gerät gespeichert. Verwenden Sie einen dedizierten Schlüssel, der widerrufen werden kann, ohne dass sich dies auf andere Integrationen auswirkt. – Das Feld „Stimme“ erfordert eine Kitta AI-Sprach-ID, nicht den Anzeigenamen der Stimme.
  • Ersetzen Sie die Systemteststimme erst durch Ihre geklonte Stimme, nachdem der erste Test erfolgreich war.
  • Netzwerkzugriff ist immer dann erforderlich, wenn Android die Engine auffordert, Sprache zu synthetisieren.

Fehlerbehebung

  • Kein Audio: Antwortformat auf wav setzen; MP3 und Opus werden aufgelistet, aber von der aktuellen App nicht dekodiert.
  • 404: Die Backend-URL muss die vollständige https://kittaai.com/v1/audio/speech-Adresse sein.
  • 401: Ersetzen Sie den gespeicherten API-Schlüssel durch einen gültigen dedizierten Schlüssel.
  • 402: Fügen Sie API-Credits hinzu, bevor Sie es erneut versuchen.
  • 400 oder ungültige Stimme: Verwenden Sie fishaudio-s21pro-flash und eine gültige Kitta AI-Sprach-ID.
  • Eine andere Stimme wird abgespielt: Wählen Sie in den System-TTS-Einstellungen von Android die Option „Benutzerdefiniertes TTS“ und prüfen Sie, ob die Ziel-App das System TTS verwendet.

Verwandte Dokumentation