Pointez le fournisseur Fish Audio de RikkaHub vers l’endpoint compatible /v1/tts, puis définissez Voice ID et modèle.

Connecter Fish Audio TTS à RikkaHub

Dans RikkaHub, choisissez le fournisseur vocal Fish Audio et pointez la base API vers Fish Audio plutôt que api.fish.audio. Configurez ensuite votre clé API, Voice ID et modèle pour /v1/tts.

Après la configuration, les demandes vocales RikkaHub consomment votre solde créditeur Fish Audio API et lisent l'audio via l'ID vocal sélectionné.

Ce dont vous avez besoin

Un compte Fish Audio avec des crédits API ;
Une clé Fish Audio API ;
Un identifiant vocal Fish Audio (reference_id) ;
RikkaHub avec le fournisseur vocal Fish Audio disponible.

Une clé API est un identifiant sensible. Ne le partagez pas dans le chat, dans des captures d'écran ou sur des sites Web non fiables. Créez une clé dédiée pour RikkaHub 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 RikkaHub. 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

RikkaHub envoie l'ID vocal sous la forme reference_id. Copiez-en un depuis votre liste vocale Fish Audio ou interrogez le API :

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

Pour tester la connexion immédiatement, commencez avec cet identifiant vocal du système public :

00a1b221-6137-4b73-ad62-b0cbce134167

Remplacez-le par votre identifiant vocal préféré une fois que RikkaHub peut générer et lire l'audio avec succès.

Ne confondez pas modèle et voix :

L'en-tête du modèle sélectionne la version du moteur TTS ;
reference_id sélectionne la voix du haut-parleur.
Liste des voix disponibles
Créer une voix personnalisée

Étape 3 : Configurer le fournisseur Fish Audio dans RikkaHub

Dans RikkaHub, ouvrez les paramètres du fournisseur Fish Audio / TTS et saisissez :

Paramètre RikkaHub	Valeur
API Hôte de base/point final	`https://fishaudio.org`
Point de terminaison complet (si nécessaire)	`https://fishaudio.org/v1/tts`
Clé API	Votre clé Fish Audio API
Modèle	`s2.1-pro` ou `s2.1-pro-flash`
Voix / `reference_id`	`00a1b221-6137-4b73-ad62-b0cbce134167` (remplacer après test)
Formater	`mp3`

Utilisez les noms de champs affichés par votre build RikkaHub. L'important est que la demande parvienne à POST https://fishaudio.org/v1/tts avec :

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

et un corps JSON qui comprend un text plus un reference_id non vide.

Si RikkaHub pré-remplit https://api.fish.audio, remplacez l'hôte par https://fishaudio.org et conservez /v1/tts.

Enregistrez le fournisseur, générez une courte phrase et confirmez que RikkaHub peut lire l'audio renvoyé.

Étape 4 : Attribuez la voix là où c'est nécessaire

Si RikkaHub vous permet de choisir une voix par personnage, chat ou assistant, collez le même identifiant vocal Fish Audio dans ce champ. Vous pouvez réutiliser une configuration de fournisseur et modifier uniquement reference_id par caractère.

API utilisation du crédit

RikkaHub appelle Fish Audio /v1/tts et consomme le solde créditeur distinct de 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. Les réponses réussies peuvent inclure X-OpenAPI-Credits-Used.

Dépannage et FAQ

RikkaHub signale un échec de connexion

Confirmez que l'hôte est https://fishaudio.org, 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 400 et mentionne `reference_id`

Fish Audio nécessite un identifiant vocal explicite. Entrez un reference_id valide ; le serveur ne choisira pas silencieusement une voix par défaut.

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 les informations d'identification stockées dans RikkaHub.

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.

RikkaHub se connecte mais ne lit pas l'audio

Testez d'abord avec mp3. Si le client a demandé opus, Fish Audio revient à mp3 afin que les lecteurs Android courants puissent décoder la réponse. Vérifiez également que l'ID vocal est valide et que les paramètres de lecture automatique ou de sourdine du RikkaHub ne bloquent pas la lecture.

Quel modèle choisir ?

Commencez par s2.1-pro ou s2.1-pro-flash. Fish Audio mappe ces étiquettes fish.audio aux identifiants de modèle de moteur correspondant. Les identifiants natifs tels que fishaudio-s21pro-flash fonctionnent également dans l'en-tête model.

Guide de configuration RikkaHub