ElevenLabs TTS
Utilisez cette compétence pour la génération de synthèse vocale ElevenLabs. Gardez la compétence réutilisable et non personnelle :
- Ne stockez pas de clés API, noms de voix, identifiants de voix, e-mails, noms de comptes, noms de clients ou valeurs par défaut personnelles dans la compétence.
- Lisez
ELEVENLABS_API_KEYdepuis l'environnement du processus ou le fichier.envle plus proche. - Lisez les profils vocaux spécifiques au compte depuis un fichier de configuration JSON local en dehors de cette compétence.
- Générez l'audio avec des paramètres au niveau de la requête. Ne modifiez pas les paramètres enregistrés du compte ElevenLabs ou de la voix, sauf si l'utilisateur le demande explicitement.
Profils locaux
Privilégiez l'une de ces sources de configuration, dans cet ordre :
--config /chemin/vers/profiles.jsonELEVENLABS_TTS_CONFIG=/chemin/vers/profiles.jsonlocal/elevenlabs/profiles.json
Les fichiers de profil locaux au projet sont également acceptables lorsqu'ils sont dans le gitignore, par exemple config/local/elevenlabs-tts.json.
Le script utilitaire attend cette structure :
{
"default_profile": "default",
"profiles": {
"default": {
"voice_name": "Nom de la voix depuis le compte local",
"voice_id": "identifiant-direct-de-voix-optionnel",
"voice_id_env": "NOM_VARIABLE_ENVIRONNEMENT_OPTIONNEL_AVEC_ID_VOIX",
"model_id": "eleven_multilingual_v2",
"output_format": "mp3_44100_128",
"voice_settings": {
"stability": 0.5,
"similarity_boost": 1.0,
"style": 0.0,
"speed": 1.0,
"use_speaker_boost": true
},
"output_dir": "outputs/voiceovers",
"emails": []
}
}
}
Les champs comme emails, propriétaires, alias et notes sont uniquement destinés au routage/contexte local. Le script ignore les champs de métadonnées inconnus.
Flux de travail
- Choisissez le profil depuis
--profile,ELEVENLABS_TTS_PROFILEoudefault_profile. - Privilégiez le script utilitaire :
python3 <racine-de-la-compétence>/scripts/generate_voice.py --text-file script.txt --profile default --output output.mp3 - Si le profil a
voice_id, utilisez-le. S'il avoice_id_env, lisez cette variable d'environnement. Sinon, recherchez ElevenLabs parvoice_name. - Utilisez le
model_id,output_formatetvoice_settingsdu profil, sauf si l'utilisateur les remplace pour cette génération. - Placez l'audio généré dans la destination demandée. Si aucune destination n'est donnée, utilisez le
output_dirdu profil, puisoutputs/voiceovers/. - Signalez le chemin de sortie et tout avertissement important. N'affichez pas de secrets.
Script utilitaire
Le script fourni prend en charge :
--text "..."pour du texte en ligne--text-file chemin.txtpour les fichiers de script- l'entrée standard lorsque ni
--textni--text-filen'est fourni --profile nompour sélectionner un profil local--config chemin.jsonpour sélectionner un fichier de profil local--voice-id,--voice-name,--model-id,--output-formatet--settings-jsonpour des remplacements ponctuels--output chemin.mp3pour choisir le fichier de sortie--dry-runpour afficher la charge utile de la requête résolue sans appeler le point de terminaison de synthèse vocale--list-voicespour lister les voix ElevenLabs correspondantes sans générer d'audio
Remarques sur l'API
Utilisez les points de terminaison actuels d'ElevenLabs :
- Recherche de voix :
GET https://api.elevenlabs.io/v2/voices - Génération de parole :
POST https://api.elevenlabs.io/v1/text-to-speech/:voice_id?output_format=...
Envoyez la clé API comme xi-api-key.