> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Authentification API

## Clés API

> **Tip**
>
> 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.
>
> ```text
> Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.
> ```
>
> [Découvrez son fonctionnement](/docs/fr/eleven-api/quickstart#set-up-with-your-coding-agent), ou consultez le [code source de la commande `onboard`](https://github.com/elevenlabs/cli/tree/main/cli/elevenlabs/workflow/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](/docs/fr/overview/administration/workspaces/api-keys#ip-allowlisting).

**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 :

```bash
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.

```bash
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` :

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

Exemple avec le package Node.js `elevenlabs` :

```javascript
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](/docs/fr/api-reference/tokens/create) pour plus d’informations.