Guide de configuration Tavo
Configurez Fish Audio en tant que fournisseur TTS personnalisé compatible OpenAI dans Tavo, puis attribuez des voix Fish Audio à vos personnages.
Connectez Fish Audio TTS à Tavo
Ce guide montre comment configurer Fish Audio en tant que fournisseur TTS personnalisé compatible OpenAI dans Tavo et attribuer une voix Fish Audio à un personnage. Après la configuration, Tavo peut lire les messages de caractères avec la voix sélectionnée.
Ce dont vous avez besoin
- Un compte Fish Audio avec des crédits API ;
- Une clé Fish Audio API ;
- L'identifiant vocal Fish Audio que vous souhaitez utiliser ;
- Une installation Tavo fonctionnelle.
Une clé API est un identifiant sensible. Ne l'envoyez pas à d'autres personnes et ne l'incluez pas dans des messages de discussion, des captures d'écran publiques ou des sites Web non fiables. Créez une clé dédiée pour Tavo afin de pouvoir la surveiller ou la révoquer séparément.
Étape 1 : Créer une clé Fish Audio API
Connectez-vous à Fish Audio, ouvrez la gestion API et créez une clé pour Tavo. Copiez-le et conservez-le immédiatement car la clé complète ne peut être affichée qu'une seule fois.
Étape 2 : Trouver un identifiant vocal
Tavo a besoin d'un identifiant vocal pour synthétiser la parole avec une voix spécifique. Copiez-en un depuis votre liste vocale Fish Audio ou interrogez le API :
Pour tester la connexion immédiatement, commencez avec cet identifiant vocal du système public :
00a1b221-6137-4b73-ad62-b0cbce134167Utilisez-le pour le test de connexion initial, puis remplacez-le par votre identifiant vocal préféré une fois que Tavo peut générer et lire l'audio avec succès.
GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEYNe confondez pas les champs modèle et voix : le modèle sélectionne le moteur TTS, tandis que le Voice ID sélectionne le son du haut-parleur.
Étape 3 : Ajouter une voix API dans Tavo
A Tavo, ouvrez :
More → Voice & Image Generation → Voice API → NewChoisissez Modèle de protocole TTS personnalisé OpenAI, puis saisissez :
| Réglage Tavo | Valeur |
|---|---|
| API URL de base | https://fishaudio.org/v1 |
| Clé API | Votre clé Fish Audio API |
| ID du modèle | fishaudio-s21pro-flash |
| Identifiant vocal | 00a1b221-6137-4b73-ad62-b0cbce134167 (remplacer après test) |
| Format audio | mp3 |
L'URL de base doit se terminer par /v1. N'ajoutez pas /audio/speech ; Tavo ajoute le chemin complet /v1/audio/speech lorsqu'il envoie une requête.
Enregistrez le fournisseur. Si Tavo propose un test de connexion, générez une courte phrase et confirmez que l'audio est lu.
Étape 4 : Attribuer la voix à un personnage
Après avoir créé la voix API, ouvrez l'écran de liaison de voix de personnage de Tavo :
Character Voice Binding → Select Character → Select Your Voice APISi Tavo demande un identifiant vocal, saisissez à nouveau le même identifiant vocal Fish Audio. Enregistrez la liaison, revenez au chat, envoyez un court message et démarrez la lecture vocale.
Vous pouvez attribuer une voix Fish Audio différente à chaque personnage. Réutilisez les paramètres du fournisseur et modifiez uniquement l'ID vocal dans chaque liaison de caractères.
API utilisation du crédit
Tavo génère la parole via Fish Audio /v1/audio/speech et consomme le solde créditeur distinct API. La synthèse vocale commence à 1 crédit API par personnage effectif, et certains modèles peuvent appliquer un multiplicateur.
Achetez des crédits auprès de Tarif API et consultez le solde dans la gestion API. Le coût réel de la demande est renvoyé dans X-OpenAPI-Credits-Used.
Dépannage et FAQ
Tavo signale un échec de connexion
Confirmez que l'URL de base est https://fishaudio.org/v1, supprimez les espaces de la clé API et vérifiez que le compte dispose toujours de crédits API. N'entrez pas le mot de passe de votre compte Fish Audio.
La requête renvoie 401 ou indique que la clé API n'est pas valide
Copiez à nouveau la clé Fish Audio API. S'il a été révoqué, créez une nouvelle clé et remplacez l'ancien identifiant stocké dans Tavo.
La requête renvoie 402 ou indique que le solde est insuffisant
Votre solde créditeur API est trop faible. Les crédits d'adhésion et les crédits API sont des soldes distincts, alors achetez des crédits API sur la page de tarification API.
Tavo se connecte mais ne lit pas l'audio
Vérifiez que le personnage est lié à la voix API et que l'ID vocal est valide. Testez d'abord une phrase courte avec mp3, puis vérifiez les paramètres de lecture automatique, de sourdine et de lecture en arrière-plan de Tavo.
Tavo dit que le modèle ou la voix n'est pas valide
Utilisez fishaudio-s21pro-flash comme ID de modèle et un ID vocal Fish Audio comme voix. Les noms OpenAI tels que tts-1 et alloy ne sont pas automatiquement mappés aux modèles ou voix Fish Audio.
Chaque personnage peut-il utiliser une voix différente ?
Oui. Entrez l'ID vocal Fish Audio correspondant pour chaque personnage afin de donner aux personnages des voix différentes.
Documentation associée
Configuration du Coze
Appelez le Fish Audio OpenAI compatible TTS API à partir d'un flux de travail Coze et renvoyez la parole générée à votre bot ou application.
Ouvrir la configuration de l'interface utilisateur Web
Configurez l'URL de base TTS compatible Fish Audio OpenAI, la clé API, le modèle et la voix dans Open WebUI.