Passer à la navigation

Documentation ElevenLabs

Explorez notre documentation et nos guides pour intégrer ElevenLabs

Démarrez avec votre agent de programmation. Aucun compte ni clé API n’est nécessaire au préalable.

Collez ce texte dans Claude Code, Cursor ou Codex. Il vous connecte ou crée un compte, crée une clé et ajoute le SDK à votre projet.

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

Découvrez son fonctionnement, ou consultez le code source de la commande onboard pour savoir exactement ce qu’elle indique à votre agent.

Comment fonctionne ElevenLabs ?

ElevenLabs fournit une infrastructure d’IA vocale : synthèse vocale, reconnaissance vocale, clonage de voix, agents vocaux et audio génératif. Vous pouvez l’utiliser de quatre manières, adaptées à différents publics.

ElevenCreative est une application web sans code où les créateurs, producteurs et monteurs génèrent des voix off, de la musique, des doublages et des projets Studio directement dans le navigateur.

ElevenAgents est la plateforme permettant de concevoir et d’exploiter des agents vocaux, avec un éditeur visuel pour les utilisateurs non techniques et un contrôle programmatique complet pour les développeurs.

ElevenAPI expose chaque fonctionnalité sous la forme d’une interface REST avec des SDK Python et TypeScript officiels, afin que les développeurs puissent intégrer la voix à leurs propres applications et flux de travail.

Reception.ai est un réceptionniste téléphonique IA prêt à déployer pour les petites et moyennes entreprises. Il répond aux appels, planifie des rendez-vous et gère les opérations quotidiennes depuis un seul Dashboard.

Choisissez votre parcours

Concepts

Les voix sont les personnalités vocales utilisées pour générer de l’audio. Chaque voix possède un identifiant unique, par exemple JBFqnCBsd6RMkjVDRZzb, que vous sélectionnez dans le Dashboard ou transmettez dans vos requêtes API. ElevenLabs propose une bibliothèque de plus de 10 000 voix. Vous pouvez aussi cloner une voix à partir d’un enregistrement audio ou en générer une depuis une description textuelle.

Les modèles déterminent la qualité, la latence et la couverture linguistique de l’audio généré. eleven_v4 produit le rendu le plus expressif dans plus de 90 langues. eleven_v4_turbo est conçu pour l’utilisation en temps réel, avec une latence médiane d’inférence d’environ 100 ms. Chaque fonctionnalité, reconnaissance vocale, musique ou effets sonores, possède son propre modèle dédié. Consultez Quel modèle dois-je utiliser ? pour en choisir un.

Comment fonctionne la tarification ?

Les crédits constituent l’unité de consommation commune à tous les produits. La synthèse vocale coûte un crédit par caractère de texte saisi. Les autres opérations sont facturées par seconde d’audio traitée. Les crédits sont réinitialisés chaque mois et les crédits non utilisés sont reportés pendant deux mois maximum. Consultez la tarification pour obtenir le détail complet.

Pour utiliser l’API sans abonnement mensuel, le paiement à l’usage vous permet de prépayer un solde, débité à mesure que vous utilisez ElevenLabs, une fois vos crédits d’abonnement épuisés.

Conçu pour la production

Quelle est la rapidité de la synthèse vocale ElevenLabs ?

Eleven Flash v2.5 génère de l’audio avec une latence d’inférence du modèle d’environ 75 ms, et Eleven v4 Turbo avec une médiane d’environ 100 ms. Scribe v2 Realtime renvoie des transcriptions partielles en environ 150 ms. Ces chiffres n’incluent pas la latence de l’application et du réseau. Le délai avant que vos utilisateurs entendent l’audio est donc plus élevé. Comprendre la latence explique ce que couvrent ces chiffres, et Optimisation de la latence indique comment réduire la latence de bout en bout.

Comment ElevenLabs gère-t-il la montée en charge ?

Votre forfait détermine le nombre de requêtes traitées simultanément. Une limite de requêtes simultanées ne plafonne pas le nombre de conversations simultanées : à titre indicatif, une limite de 5 permet généralement de prendre en charge environ 100 diffusions audio simultanées, selon les voix utilisées et le cas d’utilisation. Les forfaits Enterprise proposent des limites plus élevées. Consultez Requêtes simultanées et priorité pour connaître les limites par forfait et obtenir des conseils sur les tests de charge.

Contrôles Enterprise

  • Les déploiements privés exécutent ElevenAgents, Text to Speech et Speech to Text dans votre propre compte cloud. Vos textes, vos fichiers audio et vos transcriptions restent ainsi sur votre réseau.
  • La résidence des données stocke vos données dans des environnements isolés au sein de l’UE, en Inde ou à Singapour, plutôt que dans l’emplacement américain par défaut. Cette fonctionnalité est réservée à Enterprise.
  • Les Workspaces centralisent la facturation, les ressources partagées, les accès de l’équipe et la gestion des clés API. Les Workspaces Enterprise ajoutent l’authentification unique via SAML 2.0 ou OIDC, ainsi que des journaux d’audit des actions administratives au format OCSF.

Générez votre premier fichier audio

Installez le SDK, définissez votre clé API comme variable d’environnement et convertissez du texte en fichier MP3 en une seule requête. Pour confier cette configuration à votre agent de programmation, consultez Configuration avec votre agent de programmation.

1

Installer le SDK

pip install elevenlabs python-dotenv
2

Définir votre clé API

Créez une clé API et ajoutez-la à un fichier .env dans le répertoire de votre projet :

.env
ELEVENLABS_API_KEY=<your_api_key_here>
3

Générer et enregistrer l'audio

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
import os
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
text="The first move is what sets everything in motion.",
voice_id="JBFqnCBsd6RMkjVDRZzb", # "George" - browse voices at elevenlabs.io/app/voice-library
model_id="eleven_v4",
output_format="mp3_44100_128",
)
with open("output.mp3", "wb") as f:
for chunk in audio:
f.write(chunk)

Exécutez le script avec python example.py ou npx tsx example.mts, puis ouvrez output.mp3. Pour effectuer la même opération depuis le terminal, utilisez l’interface en ligne de commande ElevenLabs :

elevenlabs text-to-speech convert \
--voice-id JBFqnCBsd6RMkjVDRZzb \
--model-id eleven_v4 \
--text "The first move is what sets everything in motion." \
--output-format mp3_44100_128 \
--output output.mp3

Le guide de démarrage ElevenAPI détaille la même requête, y compris la configuration de l’interface en ligne de commande et la lecture audio via vos haut-parleurs.

Que puis-je concevoir avec ElevenAgents ?

ElevenAgents combine la reconnaissance vocale, le LLM de votre choix, la synthèse vocale et la gestion des tours de parole en un seul agent vocal, que vous configurez dans le Dashboard ou via les SDK.

  • Support client : répondez aux questions à partir de votre propre documentation en associant une base de connaissances à l’agent.
  • Lignes téléphoniques : connectez un numéro Twilio avec l’intégration native pour traiter les appels entrants et sortants, ou connectez votre système téléphonique existant via un trunk SIP.
  • Campagnes sortantes : passez de nombreux appels sortants simultanément grâce aux appels par lot.
  • Sites web et applications : intégrez un agent qui traite la voix et le texte grâce au widget.

Le guide de démarrage ElevenAgents vous accompagne dans la conception de votre premier agent de bout en bout.

Quel modèle dois-je utiliser ?

Partez de votre cas d’utilisation. Chaque ID de modèle ci-dessous est la valeur à transmettre comme model_id dans les requêtes API.

Cas d’utilisationModèle recommandéID de modèlePourquoi
Agents vocaux en temps réelEleven v4 Turboeleven_v4_turboLatence médiane d’inférence d’environ 100 ms† avec le rendu en temps réel le plus expressif. Pour la latence la plus faible, utilisez eleven_flash_v2_5 (~75 ms†).
Narration expressive ou longueEleven v4eleven_v4Le modèle le plus expressif, adapté aux livres audio et aux voix off de personnages. Jusqu’à 10 000 caractères (~10 minutes d’audio) par requête. Pour un rendu long format plus stable, utilisez eleven_multilingual_v2.
Contenu multilingueEleven v4eleven_v4Plus de 90 langues avec une qualité vocale constante lors des changements de langue. eleven_v4_turbo couvre les mêmes langues en temps réel.
Coût le plus basEleven Flash v2.5eleven_flash_v2_5Prix par caractère inférieur de 50 % pour les générations via API, 32 langues et jusqu’à 40 000 caractères par requête.
Reconnaissance vocale par lotScribe v2scribe_v2Transcription dans plus de 90 langues avec horodatage au mot, diarisation jusqu’à 32 locuteurs et amorçage par termes clés. Utilisez scribe_v2_medical pour l’audio clinique.
Reconnaissance vocale en temps réelScribe v2 Realtimescribe_v2_realtimeDiffuse des transcriptions avec une latence d’environ 150 ms† dans plus de 90 langues.

Consultez Choisir le bon modèle pour d’autres cas d’utilisation et la référence des modèles pour les spécifications complètes.

† Hors latence de l’application et du réseau. Consultez Comprendre la latence.

Parcourir par fonctionnalité

Construit avec