Premiers pas

Guide de démarrage rapide ElevenAPI

Apprenez à effectuer votre première requête à l’API ElevenLabs.

À la fin de ce guide, vous disposerez d’un script fonctionnel qui envoie une chaîne de texte à l’API ElevenLabs et lit l’audio renvoyé sur vos haut-parleurs. Vous apprendrez à vous authentifier avec une clé API, à installer le SDK et à effectuer votre première requête Text to Speech.

Pour les guides sur d’autres fonctionnalités, notamment le streaming, le clonage de voix et le Speech to Text, consultez la section Tutoriels.

Utilisez la compétence Text to Speech d’ElevenLabs pour générer de la parole depuis votre assistant de programmation IA :

npx skills add elevenlabs/skills --skill text-to-speech

Utiliser l’API Text to Speech

1

Créer une clé API

Créez une clé API dans le Dashboard ici, que vous utiliserez pour accéder à l’API de manière sécurisée.

Stockez la clé comme secret géré et transmettez-la aux SDK soit en tant que variable d’environnement via un fichier .env, soit directement dans la configuration de votre application, selon vos préférences.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Installer le SDK

Nous utiliserons également la bibliothèque dotenv pour charger notre clé API depuis une variable d’environnement.

pip install elevenlabs
pip install python-dotenv

Pour lire l’audio sur vos haut-parleurs, vous devrez peut-être installer MPV et/ou ffmpeg.

3

Effectuer votre première requête

Créez un fichier nommé example.py ou example.mts, selon le langage choisi, puis ajoutez le code suivant :

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
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",
)
play(audio)

Exécutez-le ensuite :

python example.py

Vous devriez entendre l’audio être lu sur vos haut-parleurs.

Étapes suivantes

Diffuser l’audio

Réduisez la latence en diffusant l’audio à mesure de sa génération plutôt qu’en attendant le fichier complet

Parcourir les voix

Explorez plus de 10 000 voix et remplacez l’ID de voix de l’exemple par celui qui convient à votre cas d’utilisation

Cloner une voix

Créez une voix personnalisée à partir d’un court enregistrement audio