Passer à la navigation

Démarrage rapide avec ElevenAPI

Découvrez comment effectuer votre première requête API ElevenLabs.

À la fin de ce guide, vous aurez configuré ElevenLabs dans votre projet et pourrez effectuer votre première requête de synthèse vocale. Deux options s’offrent à vous : laissez votre agent de programmation effectuer la configuration ou faites-le manuellement.

Pour des guides sur d’autres fonctionnalités, comme le streaming, le clonage de voix et la transcription, consultez la section Tutoriels.

Configurer avec votre agent de programmation

Vous n’avez pas besoin de compte ni de clé API avant de commencer. Collez ceci dans votre agent de programmation :

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

La CLI ElevenLabs s’occupe du reste et indique chaque étape à votre agent. Votre navigateur s’ouvre une fois afin que vous puissiez vous connecter ou créer un compte, puis cliquer sur Authorize. La clé est enregistrée dans le fichier env de votre projet (.env.local ou .env dans un projet Python) et exclue de git ; elle n’apparaît jamais dans le chat. L’agent vous demande ensuite ce que vous souhaitez concevoir, installe le SDK, ajoute le code à votre application et vous demande si vous souhaitez envoyer une requête de test.

Si votre agent s’exécute dans un environnement inaccessible depuis votre navigateur, par exemple sur une machine distante via SSH ou dans un bac à sable cloud, la CLI vous demande de créer une clé vous-même et de la coller dans le fichier env, puis continue. La commande nécessite Node.js pour npx. Sans Node.js, installez la CLI ElevenLabs avec Homebrew (macOS et Linux) ou Scoop (Windows), ou mettez-la à jour si vous l’avez déjà (brew upgrade elevenlabs, scoop update elevenlabs), puis demandez à votre agent d’exécuter elevenlabs onboard init à la place.

Configurer manuellement

1

Créer une clé API

Créez une clé API dans le Dashboard ici, que vous utiliserez pour accéder à l’API en toute sécurité.

Stockez la clé comme secret géré et transmettez-la aux SDK, soit sous forme de 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 via vos haut-parleurs, vous devrez peut-être installer MPV et/ou ffmpeg.

3

Effectuer votre première requête

Créez un nouveau fichier nommé example.py ou example.mts, selon le langage de votre choix, 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 via vos haut-parleurs.

Étapes suivantes