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

Connecter Kitta AI TTS à RikkaHub

Dans RikkaHub, choisissez le fournisseur vocal Kitta AI et pointez la base API vers Kitta AI 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 Kitta AI API et lisent l'audio via l'ID vocal sélectionné.

Ce dont vous avez besoin

Un compte Kitta AI avec des crédits API ;
Une clé Kitta AI API ;
Un identifiant vocal Kitta AI (reference_id) ;
RikkaHub avec le fournisseur vocal Kitta AI 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é Kitta AI API

Connectez-vous à Kitta AI, 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 Kitta AI 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 Kitta AI dans RikkaHub

Dans RikkaHub, ouvrez les paramètres du fournisseur Kitta AI / TTS et saisissez :

Paramètre RikkaHub	Valeur
API Hôte de base/point final	`https://kittaai.com`
Point de terminaison complet (si nécessaire)	`https://kittaai.com/v1/tts`
Clé API	Votre clé Kitta AI 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://kittaai.com/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://kittaai.com 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 Kitta AI 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 Kitta AI /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://kittaai.com, 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 Kitta AI.

La requête renvoie 400 et mentionne `reference_id`

Kitta AI 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é Kitta AI 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, Kitta AI 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. Kitta AI 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