Passer à la navigation
API reference

Authentification API

Découvrez comment authentifier vos requêtes vers l’API ElevenLabs

Clés API

Ne vous occupez pas de la clé. Laissez votre agent de programmation s’en charger.

Collez ce texte dans Claude Code, Cursor ou Codex. Il vous connecte ou crée un compte, génère 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 voir précisément ce qu’elle indique à votre agent.

L’API ElevenLabs utilise des clés API pour l’authentification. Chaque requête adressée à l’API doit inclure votre clé API afin d’authentifier vos requêtes et de suivre votre quota d’utilisation.

Chaque clé API peut être configurée avec les restrictions suivantes :

  1. Restriction de portée : définissez des restrictions d’accès en limitant les points de terminaison API auxquels la clé peut accéder.
  2. Quota de crédits : définissez des limites de crédits personnalisées pour contrôler l’utilisation.
  3. Liste d’autorisation IP : limitez la clé à des adresses IP ou à des plages CIDR spécifiques. Les requêtes provenant d’adresses IP non autorisées sont rejetées avec une erreur 403. En savoir plus.

N’oubliez pas que votre clé API est secrète. Ne la partagez pas avec d’autres personnes et ne l’exposez dans aucun code côté client (navigateurs, applications).

Toutes les requêtes API doivent inclure votre clé API dans un en-tête HTTP xi-api-key, comme suit :

xi-api-key: ELEVENLABS_API_KEY

Effectuer des requêtes

Vous pouvez coller la commande ci-dessous dans votre terminal pour effectuer votre première requête API. Veillez à remplacer $ELEVENLABS_API_KEY par votre clé API secrète.

curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'

Exemple avec le package Python elevenlabs :

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)

Exemple avec le package Node.js elevenlabs :

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

Jetons à usage unique

Pour certains points de terminaison, vous pouvez utiliser des jetons à usage unique pour authentifier vos requêtes. Ces jetons sont valides pendant une durée limitée et permettent de se connecter à l’API sans exposer votre clé API, par exemple depuis le côté client.

Consultez la documentation sur les jetons à usage unique pour plus d’informations.