Kitta AI Docs
Guides d'intégrationIntégrations tierces
Back to site

Guide de configuration OpenMAIC

Ajoutez Kitta AI en tant que fournisseur TTS personnalisé compatible OpenAI dans OpenMAIC pour les enseignants d'IA, les camarades de classe et la narration de cours.

Connectez Kitta AI TTS à OpenMAIC

OpenMAIC prend en charge les fournisseurs TTS personnalisés compatibles OpenAI. Après avoir connecté Kitta AI, les professeurs d'IA, les camarades de classe, la narration du cours et le contenu généré peuvent utiliser la voix sélectionnée.

Préparez une clé API et un identifiant vocal

  1. Créez une clé dédiée dans Gestion API.
  2. Ouvrez votre voix clonée et copiez son identifiant vocal.
  3. Confirmez que votre solde créditeur API est suffisant.

Pour un test rapide, utilisez :

00a1b221-6137-4b73-ad62-b0cbce134167

Ajouter un fournisseur personnalisé dans Paramètres

Ouvrez Settings → TTS et ajoutez un fournisseur TTS personnalisé compatible OpenAI. Entrer:

Paramètre OpenMAICValeur
Nom du fournisseurKitta AI
URL de basehttps://kittaai.com/v1
Clé APIVotre clé Kitta AI API
Modèlefishaudio-s21pro-flash
Identifiant vocalL'identifiant vocal de votre voix clonée
Nom de la voixN’importe quel nom d’affichage

OpenMAIC ajoute /audio/speech à l'URL de base et envoie la requête finale à POST /v1/audio/speech. Ne placez pas le point de terminaison complet dans le champ URL de base.

Après avoir ajouté la voix, faites-en le fournisseur TTS actif et sélectionnez le nouvel ID vocal. Utilisez le bouton de test TTS avec une courte phrase pour vérifier la voix et l'authentification.

Prefer server-side keys for shared deployments

OpenMAIC peut stocker des fournisseurs personnalisés dans les paramètres client. Entrez-y une clé API uniquement sur un instance auto-hébergée. Pour les déploiements publics ou multi-utilisateurs, les administrateurs doivent configurer TTS côté serveur afin que la clé ne soit pas exposée aux utilisateurs du navigateur.

Configuration côté serveur

Les administrateurs auto-hébergés peuvent configurer Kitta AI avec les variables d'environnement OpenMAIC :

TTS_OPENAI_API_KEY=YOUR_FISH_AUDIO_API_KEY
TTS_OPENAI_BASE_URL=https://kittaai.com/v1

Redémarrez OpenMAIC après avoir modifié l'environnement. Sélectionnez ensuite le fournisseur OpenAI dans les paramètres TTS et remplacez le modèle et la voix par l'ID de modèle et l'ID vocal Kitta AI.

Dépannage

  • 404 : l'URL de base doit s'arrêter à /v1. N'entrez pas /v1/audio/speech, car cela pourrait dupliquer le chemin.
  • 401 : vérifiez la clé API du fournisseur actif. Redémarrez OpenMAIC après avoir modifié une clé côté serveur.
  • 402 : ajoutez des crédits API avant de réessayer.
  • 400 : utilisez fishaudio-s21pro-flash comme modèle et un identifiant vocal valide.
  • Le test fonctionne mais la classe est silencieuse : faites de Kitta AI le fournisseur actif et attribuez sa voix au rôle de narration.
  • Cors du navigateur ou problèmes clés : utilisez la configuration TTS côté serveur d'OpenMAIC sur un déploiement partagé.

Documentation associée