Configuration de la clé API ElevenLabs

Guider l'utilisateur à travers l'obtention et la configuration d'une clé API ElevenLabs.

Workflow

Étape 0 : Vérifier d'abord une clé API existante

Avant de demander une clé à l'utilisateur, vérifier l'existence d'une ELEVENLABS_API_KEY :

1. Vérifier si ELEVENLABS_API_KEY existe dans l'environnement actuel.
2. Si elle ne figure pas dans l'environnement, vérifier .env pour ELEVENLABS_API_KEY=<value>.
3. Si une clé existante est trouvée, la valider :

   GET https://api.elevenlabs.io/v1/user
   Header: xi-api-key: <existing-api-key>

4. Si la validation de la clé existante réussit :
   • Dire à l'utilisateur qu'ElevenLabs est déjà configuré et fonctionne
   • Ignorer le flux de configuration
   • Demander s'il souhaite remplacer/renouveler la clé ; sinon, arrêter
5. Si la validation de la clé existante échoue :
   • Dire à l'utilisateur que la clé existante semble invalide ou expirée
   • Continuer à l'étape 1

Étape 1 : Demander la clé API

Dire à l'utilisateur :

Pour configurer ElevenLabs, ouvrez la page des clés API : https://elevenlabs.io/app/settings/api-keys

(Besoin d'un compte ? Créez-en un à https://elevenlabs.io/app/sign-up d'abord)

Si vous n'avez pas encore de clé API :

1. Cliquez sur « Create key »
2. Nommez-la (ou utilisez la valeur par défaut)
3. Définissez la permission pour votre clé. Si vous fournissez une clé avec la permission « User » définie sur « Read », cette skill vérifiera automatiquement si votre clé fonctionne
4. Cliquez sur « Create key » pour confirmer
5. Copiez la clé immédiatement - elle n'est affichée qu'une seule fois !

Collez votre clé API ici quand vous êtes prêt.

Puis attendre le message suivant de l'utilisateur, qui devrait contenir la clé API.

Étape 2 : Valider et configurer

Une fois que l'utilisateur fournit la clé API :

1. Valider la clé en effectuant une requête :

   GET https://api.elevenlabs.io/v1/user
   Header: xi-api-key: <the-api-key>

2. Si la validation échoue :

   • Dire à l'utilisateur que la clé API semble invalide
   • Lui demander de réessayer
   • Lui rappeler l'URL : https://elevenlabs.io/app/settings/api-keys
   • Si cela échoue une deuxième fois, afficher une erreur et quitter

3. Si la validation réussit, enregistrer la clé API dans un fichier .env :

   ELEVENLABS_API_KEY=<the-api-key>

   • Si .env contient déjà ELEVENLABS_API_KEY=..., remplacer cette ligne
   • Sinon, ajouter une nouvelle ligne pour ELEVENLABS_API_KEY

4. Confirmer le succès :

   C'est fait ! Votre clé est stockée comme variable d'environnement dans .env Gardez la clé en sécurité ! Ne la partagez avec personne !