Fish Audio Docs
Guides d'intégrationIntégrations tierces
Back to site

Configuration de RimTalk TTS

Ajoutez Fish Audio comme fournisseur compatible OpenAI dans RimTalk TTS et attribuez une voix différente à chaque colon de RimWorld.

Connecter Fish Audio TTS à RimTalk

RimTalk TTS peut appeler Fish Audio avec un fournisseur personnalisé compatible OpenAI afin de lire les dialogues des colons avec les voix choisies.

Vérifiez d'abord la version de RimTalk

Les réglages doivent afficher Custom TTS Providers (Untested!) et le bouton d'ajout d'un fournisseur. Cette fonction se trouve actuellement dans la version de développement du projet. Si elle est absente, vérifiez la provenance et la version du mod.

Préparation

Créez une clé API réservée à RimTalk et récupérez un Voice ID Fish Audio. Ne publiez jamais la clé complète dans une capture, une conversation ou un fichier du mod. Révoquez immédiatement toute clé déjà exposée.

Cette voix système permet d'effectuer le premier test :

00a1b221-6137-4b73-ad62-b0cbce134167

Ajouter le fournisseur

Ouvrez TTS Configuration → Custom TTS Providers → Add New Custom Provider, puis saisissez :

ChampValeur
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 suivi d'une espace
Timeout60 secondes

L'URL complète doit être https://fishaudio.org/v1/audio/speech. Activez speed et désactivez streaming, temperature, top_p, les champs d'émotion et le corps personnalisé.

N'utilisez pas tts-1, alloy ni l'ancien identifiant s2.1-pro. Le modèle du moteur et l'UUID de la voix sont deux valeurs distinctes.

Attribuer les voix

Enregistrez et sélectionnez le nouveau fournisseur. Dans la liste des modèles vocaux, ajoutez un nom lisible et collez l'UUID de la voix Fish Audio dans Model ID. Choisissez la voix par défaut, puis attribuez une voix à chaque Pawn.

Test et dépannage

Commencez par une phrase courte prononcée par un seul colon. Vérifiez la réponse HTTP 200, la lecture complète du MP3 et la consommation dans la gestion de l'API.

  • 401 : vérifiez la clé et l'espace après Bearer.
  • 402 : ajoutez des crédits API.
  • 404 : la Base URL se termine par /v1 et le chemin vaut /audio/speech.
  • 400 : contrôlez le modèle et l'UUID vocal.
  • Délai dépassé : utilisez le modèle flash, 60 secondes et un texte court.
  • 429 : conservez le délai entre générations et réduisez les appels simultanés.

RimTalk attend une réponse audio synchrone et ne consulte pas les tâches asynchrones. Raccourcissez les entrées trop longues.

Documentation associée