API reference

Authentification API

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

Clés API

L’API ElevenLabs utilise des clés API pour l’authentification. Chaque requête adressée à l’API doit inclure votre clé API, qui permet 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 endpoints 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, tel que des navigateurs ou des 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 exécuter 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 endpoints, vous pouvez utiliser des jetons à usage unique afin d’authentifier vos requêtes. Ces jetons sont valides pendant une durée limitée et permettent de vous connecter à l’API sans exposer votre clé API, par exemple côté client.

Consultez la documentation Jetons à usage unique pour en savoir plus.