Aller au contenu

Commandes ElevenLabs

Commandes et workflows complets d’ElevenLabs pour la synthèse vocale par IA et la génération de voix.

Authentification API

CommandeDescription
curl -H "xi-api-key: <api-key>" <endpoint>Authentification API
export ELEVEN_API_KEY=<key>Définir la variable d’environnement
elevenlabs auth loginSe connecter au compte
elevenlabs auth logoutSe déconnecter du compte
elevenlabs auth statusVérifier le statut d’authentification

API Texte-à-Parole

EndpointDescription
POST /v1/text-to-speech/{voice_id}Générer un discours
POST /v1/text-to-speech/{voice_id}/streamFlux de parole
GET /v1/voicesLister les voix disponibles
GET /v1/voices/{voice_id}Obtenir les détails de la voix
POST /v1/voices/addAjouter une voix personnalisée

Gestion des Voix

CommandeDescription
GET /v1/voicesLister toutes les voix
GET /v1/voices/{voice_id}Obtenir les informations vocales
DELETE /v1/voices/{voice_id}Supprimer la voix personnalisée
POST /v1/voices/{voice_id}/editModifier les paramètres vocaux
GET /v1/voices/settingsObtenir les paramètres vocaux

Génération de Parole

CommandeDescription
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM" -H "xi-api-key: <key>" -H "Content-Type: application/json" -d '{"text": "Hello world"}'Génération de discours de base
curl -X POST "https://api.elevenlabs.io/v1/text-to-speech/21m00Tcm4TlvDq8ikWAM/stream" -H "xi-api-key: <key>"Streaming speech

SDK Python

CommandeDescription
pip install elevenlabsInstaller Python SDK
from elevenlabs import generate, playImporter SDK
generate(text="Hello", voice="Bella")Générer un discours
play(audio)Lire l’audio généré
save(audio, "output.mp3")Enregistrer le fichier audio

Clonage de Voix

CommandeDescription
POST /v1/voices/addCloner la voix à partir d’échantillons
POST /v1/voices/{voice_id}/samplesAjouter des échantillons vocaux
DELETE /v1/voices/{voice_id}/samples/{sample_id}Supprimer l’échantillon vocal
GET /v1/voices/{voice_id}/samplesLister les échantillons vocaux

Paramètres Vocaux

ParamètreDescription
stabilityCohérence vocale (0.0-1.0)
similarity_boostSimilarité vocale (0.0-1.0)
styleStyle de parole (0.0-1.0)
use_speaker_boostAméliorer la similarité des haut-parleurs

Formats Audio

FormatDescription
mp3_44100_128MP3 44,1 kHz 128 kbps
mp3_22050_32MP3 22,05 kHz 32 kbps
pcm_16000PCM 16 kHz
pcm_22050PCM 22,05 kHz
pcm_24000PCM 24 kHz
pcm_44100PCM 44,1 kHz

Voix Prédéfinies

Voice IDNomDescription
21m00Tcm4TlvDq8ikWAMRachelAméricaine féminin
AZnzlk1XvdvUeBnXmlldDomiAmerican female
EXAVITQu4vr4xnSDxMaLBellaAméricaine féminin
ErXwobaYiN019PkySvjVAntoniHomme américain
MF3mGyEYCl7XYWbV9V6OElliAméricaine féminin
TxGEqnHWrfWFTfGW9XjXJoshHomme américain
VR6AewLTigWG4xSOukaGArnoldHomme américain
pNInz6obpgDQGcFmaJgBAdamHomme américain

SDK Node.js

CommandeDescription
npm install elevenlabsInstaller Node.js SDK
const { ElevenLabsAPI } = require('elevenlabs')Importer SDK
const client = new ElevenLabsAPI({ apiKey: 'key' })Initialiser client
client.textToSpeech.generate()Générer un discours

Audio en Streaming

CommandeDescription
POST /v1/text-to-speech/{voice_id}/streamStreamer l’audio
curl -X POST -H "xi-api-key: <key>" --data-raw '{"text":"Hello"}' --output audio.mp3Flux vers fichier

Fonctionnalités du Voice Lab

FonctionnalitéDescription
Voice DesignCréer des voix synthétiques
Voice CloningCloner des voix existantes
Professional CloningClonage vocal de haute qualité
Voice LibraryParcourir la collection vocale

Limites de Taux API

PlanCaractères/MoisRequêtes Concurrentes
Free10 0002
Starter30 0003
Creator100 0005
Pro500 00010
Scale2 000 00025

Gestion des Erreurs

Code d’erreurDescription
400Mauvaise Requête
401Non autorisé
403Interdit
404Non trouvé
422Unprocessable Entity
429Trop de Requêtes
500Erreur de serveur interne

Paramètres Avancés

ParamètreDescription
model_idModèle TTS à utiliser
voice_settingsConfiguration vocale
pronunciation_dictionary_locatorsPrononciations personnalisées
seedGénération reproductible

Configuration du Webhook

CommandeDescription
POST /v1/webhooksCréer un webhook
GET /v1/webhooksLister les webhooks
DELETE /v1/webhooks/{webhook_id}Supprimer webhook
PUT /v1/webhooks/{webhook_id}Mettre à jour le webhook

Projets et Doublage

CommandeDescription
POST /v1/projectsCréer un projet
GET /v1/projectsLister les projets
POST /v1/dubbingCréer un projet de doublage
GET /v1/dubbing/{dubbing_id}Obtenir le statut de doublage

Analytiques d’Utilisation

CommandeDescription
GET /v1/user/subscriptionObtenir les informations d’abonnement
GET /v1/userObtenir les informations de l’utilisateur
GET /v1/usage/character-statsObtenir les statistiques d’utilisation

Outil CLI

CommandeDescription
elevenlabs --helpAfficher l’aide
elevenlabs tts --text "Hello" --voice RachelGénérer un discours
elevenlabs voices listLister les voix
elevenlabs voices clone --name "MyVoice"Cloner la voix
CodeDescription
audio = generate(text="Hello", voice="Bella", model="eleven_monolingual_v1")Génération de base
play(audio)Lire l’audio
save(audio, "hello.mp3")Enregistrer dans un fichier
CodeDescription
const audio = await elevenlabs.generate({ text: "Hello", voice: "Rachel" })Générer un audio
fs.writeFileSync("audio.mp3", audio)Enregistrer dans un fichier
ÉtapeDescription
1. Upload samplesFournir des échantillons vocaux
2. Train modelL’IA apprend les modèles vocaux
3. Test generationVérifier la qualité vocale
4. Fine-tune settingsAjuster les paramètres
5. Deploy voiceUtiliser en production
PratiqueDescription
Clear audio samplesEnregistrements de haute qualité
Diverse samplesDiverses émotions/styles
Consistent speakerMême personne tout au long
Proper length1-5 minutes au total
Good microphoneEnregistrement professionnel
PlateformeIntégration
Discord BotGénération de message vocal
PodcastNarration automatisée
E-learningVoix-off de cours
GamingVoix des personnages
AccessibilitySynthèse vocale pour personnes malvoyantes
ProblèmeSolution
Poor voice qualityAméliorer la qualité des échantillons
Rate limit exceededMettre à niveau le plan ou attendre
Authentication failedVérifier la clé API
Voice not foundVérifier l’ID vocal
Audio distortionAjuster les paramètres vocaux
VariableDescription
ELEVEN_API_KEYClé d’authentification API
ELEVEN_API_URLURL de base de l’API
ELEVEN_TIMEOUTDélai de requête
FichierDescription
.elevenlabs.jsonFichier de configuration
voices.jsonDéfinitions vocales
settings.jsonParamètres par défaut
MétriqueDescription
----------------------
Characters usedUtilisation mensuelle
API callsNombre de requêtes
Voice generationsAudio créé
Error rateRequêtes échouées