Passer au contenu principal

​
Introduction

Cette page couvre la configuration globale (clé d’API, voix et modèle par défaut). Pour personnaliser la voix d’un personnage spécifique, voir Configuration vocale par personnage. ElevenLabs est le moteur vocal utilisé par Fanify pour :

​
Prérequis

  • Un compte elevenlabs (avec abonnement, fortement recommendé)
  • Un abonnement ElevenLabs adapté au volume vocal prévu (le plan gratuit est limité)
  • Accès administrateur à votre instance Fanify
Sans clé ElevenLabs valide, le VoiceChanger et la transcription audio ElevenLabs ne fonctionneront pas.
Fanify nécessite un abonnement Elevenlabs pour disposer de toutes les fonctionnalitées (minimum Creative Starter, $6/mois). ElevenLabs fonctionne par abonnement mensuel avec un quota de crédits mensuel, pas à la consommation. Le plan gratuit inclut 10 000 crédits mensuels et l’accès API de base au TTS, au STS et à la transcription Scribe de manière limitée (voix utilisable et traffic limité). Pour un usage en production, un abonnement payant est recommandé afin de bénéficier d’une licence commerciale, d’un quota suffisant et d’un accès API sans restriction de rate limit. Fanify permet également d’utiliser FishAudio comme fournisseur alternatif pour le TTS.

​
Étapes

​
1) Créer une clé d’API ElevenLabs

  1. Connectez-vous sur elevenlabs.io
  2. Ouvrez la page API Keys
  3. Cliquez sur Create API Key, donnez-lui un nom (ex : Fanify)
  4. Laissez l’option Restricted Keys décochée (clé non restreinte)
  5. Copiez la clé générée
Par défaut, créez une clé non restreinte (option Restricted Keys décochée) : c’est l’option recommandée pour la quasi-totalité des utilisateurs. Fanify dispose ainsi de toutes les permissions dont il a besoin. Les utilisateurs avancés et soucieux de sécurité peuvent créer une clé restreinte avec les permissions exactes.
La clé n’est affichée qu’une seule fois. Conservez-la en lieu sûr le temps de la coller dans Fanify.

​
2) Saisir la clé dans Fanify

  1. Onglet Admin Onglet Admin
  2. Section Services Section Services
  3. Cliquez sur ElevenLabs Service ElevenLabs
  4. Collez la clé dans Clé d’API, puis Enregistrer
Le guide de mise en route vous redirige directement vers cet écran via l’étape « Fournisseur d’inférence vocale ».
Une fois la clé enregistrée, Fanify peut interroger ElevenLabs pour lister les voix et modèles disponibles. Ces deux paramètres restent à choisir manuellement à l’étape suivante.
La page affiche aussi votre quota de caractères restant, actualisé automatiquement (environ toutes les 4 heures). Lorsque le quota est épuisé, Fanify le signale par un badge Plus de crédits : montez de plan ou attendez le renouvellement mensuel de votre abonnement.

​
3) Choisir le modèle Speech-to-Speech

Dans Admin > Services > ElevenLabs, section Modèle & Voix :
  1. Cliquez sur Actualiser les données si la liste est vide (Fanify récupère alors voix et modèles depuis ElevenLabs)
  2. Dans Modèle, sélectionnez eleven_multilingual_sts_v2 pour activer le VoiceChanger en français (et autres langues)
  3. Cliquez sur Enregistrer
Le VoiceChanger en chatting requiert un modèle Speech-to-Speech (sts). Les modèles Text-to-Speech (TTS) ne fonctionneront pas pour cette fonctionnalité. eleven_multilingual_sts_v2 est le choix recommandé pour le multilingue.

​
4) Choisir une voix par défaut

Toujours dans Modèle & Voix :
  1. Dans Voix, sélectionnez la voix à utiliser par défaut pour le VoiceChanger
  2. Cliquez sur Enregistrer
Si la liste est vide ou ne contient pas la voix souhaitée, vous pouvez créer ou cloner une voix directement depuis votre dashboard ElevenLabs :
  • Voice Library : voix publiques à ajouter à votre compte
  • Voice Lab : clonage de voix à partir d’échantillons audio
Après création/clonage côté ElevenLabs, revenez dans Fanify et cliquez sur Actualiser les données pour faire apparaître la nouvelle voix dans la liste.
Cette voix sert de fallback global pour tous les personnages qui n’ont pas leur propre voix configurée.

​
5) (optionnel) Ajuster les paramètres vocaux

Section Paramètres de voix : ajustez Stability, Similarity Boost, Style et Speed pour calibrer le rendu sonore. Cliquez sur Enregistrer. Les valeurs par défaut conviennent à la plupart des cas. Modifiez-les si la voix sort trop monotone (baisser Stability), trop éloignée de l’original (monter Similarity Boost), etc.

​
6) Tester le VoiceChanger

  1. Ouvrez l’onglet Chatting Onglet Chatting
  2. Sélectionnez une conversation
  3. Enregistrez un message vocal et activez le VoiceChanger avant envoi
  4. Le message est converti dans la voix configurée puis envoyé

​
Configuration vocale par personnage

La voix configurée dans Admin > Services > ElevenLabs est utilisée par défaut pour tous les personnages. Pour donner une voix spécifique à un personnage :
  1. Onglet Content Factory Onglet Content Factory
  2. Ouvrez le personnage principal
  3. Section Configuration vocale : choisissez le fournisseur (ElevenLabs / FishAudio), la voix et le modèle pour chaque modalité (STS, TTS)
Une documentation avancée dédiée à la configuration vocale par personnage sera publiée ultérieurement.

​
Hiérarchie des paramètres vocaux

Lors d’un changement de voix, Fanify résout la configuration dans cet ordre (du plus prioritaire au moins prioritaire) :
PrioritéSourcePortée
1Paramètres opérateur (Settings personnels de l’opérateur)Surcharge uniquement les paramètres de voix (Stability, Similarity Boost, etc.) pour cet opérateur
2Configuration du personnage (Content Factory > Personnage)Voix, modèle et paramètres spécifiques au personnage utilisé dans la conversation
3Configuration globale ElevenLabs (Admin > Services > ElevenLabs)Voix, modèle et paramètres par défaut de l’instance
Concrètement : si un opérateur a personnalisé ses curseurs, ils sont utilisés ; sinon ceux du personnage ; sinon ceux définis globalement par l’admin. La voix et le modèle ne sont jamais surchargés au niveau opérateur, uniquement les paramètres de rendu.
Chaque opérateur ayant une voix différente, les curseurs se doivent d’être configurés pour chaque opérateur afin d’avoir une qualité de génération optimale.

​
Dépannage rapide

  • Clé invalide / 401 : vérifiez la clé sur elevenlabs.io, cliquez sur Actualiser les données
  • Permission manquante : un message du type missing the permission user_read (ou models_read, voices_read) signifie que votre clé restreinte ne dispose pas d’un droit requis par Fanify. La solution la plus simple est de créer une clé non restreinte (option Restricted Keys décochée). Sinon, ajoutez la permission manquante en suivant le tableau de la section Créer une clé restreinte, puis ressaisissez la clé dans Fanify
  • Aucune voix listée : enregistrez la clé d’API, puis cliquez sur Actualiser les données
  • Quota dépassé : vérifiez votre crédit caractères sur ElevenLabs, montez de plan si nécessaire
  • Voix trop différente de l’audio source : augmentez Similarity Boost dans les paramètres de voix
  • VoiceChanger indisponible en chatting : vérifiez qu’une voix est sélectionnée par défaut, ou configurée sur le personnage, et qu’une clé ElevenLabs valide est configurée (le VoiceChanger / STS n’est supporté que par ElevenLabs)

​
Créer une clé restreinte (utilisateurs avancés)

Cette option s’adresse aux utilisateurs soucieux de sécurité qui préfèrent limiter les permissions de la clé fournie à Fanify. Elle est facultative : une clé non restreinte couvre tous les besoins. Une clé restreinte doit disposer des permissions exactes suivantes pour que Fanify fonctionne :
RessourcePermissionUsage dans Fanify
UserRead (user_read)Lecture de l’abonnement et du quota de crédits
ModelsRead (models_read)Liste des modèles TTS / STS disponibles
VoicesRead (voices_read)Liste des voix disponibles
Text to SpeechAccessGénération vocale (TTS)
Speech to SpeechAccessChangement de voix / VoiceChanger (STS)
Speech to TextAccessTranscription des messages vocaux entrants (STT)
1

Ouvrir la création de clé

Sur la page API Keys, cliquez sur Create API Key et donnez-lui un nom explicite (ex : Fanify).
2

Activer le mode restreint

Cochez l’option Restricted Keys.
3

Attribuer les permissions

Accordez les accès du tableau ci-dessus : User (Read), Models (Read), Voices (Read), puis Access pour Text to Speech, Speech to Speech et Speech to Text. Laissez le reste sur No access.
4

Créer et copier la clé

Validez la création, puis copiez la clé et collez-la dans Fanify comme une clé standard (étape 2).
Si une permission manque, Fanify rejette la configuration avec le message d’erreur brut renvoyé par ElevenLabs (par exemple missing the permission models_read). Ajoutez la permission indiquée, puis ressaisissez la clé.

​
Liens utiles