# Authentification

> Authentifiez les appels API LLMoxy à l'aide de jetons et d'en-têtes de requête compatibles.

Les interfaces Relay LLMoxy nécessitent un jeton API utilisateur. Les jetons peuvent être créés dans **Console -> Jetons**, et commencent généralement par `sk-`.

## Bearer Token

L'en-tête standard est recommandé :

```http
Authorization: Bearer <LLMOXY_API_KEY>
```

Exemple :

```bash
curl https://llmoxy.com/v1/models \
  -H "Authorization: Bearer <LLMOXY_API_KEY>"
```

## En-tête LLMOXY-API-KEY

Lorsqu'une requête n'a pas d'`Authorization`, LLMoxy accepte également :

```http
LLMOXY-API-KEY: <LLMOXY_API_KEY>
```

Privilégiez `Authorization: Bearer`. L'en-tête personnalisé sert principalement aux scénarios d'intégration où il est difficile de définir l'en-tête d'authentification standard.

## Requêtes compatibles Claude

Pour `/v1/messages` et `/v1/models`, les clients de style Anthropic peuvent utiliser :

```http
x-api-key: <LLMOXY_API_KEY>
anthropic-version: 2023-06-01
```

LLMoxy mappe `x-api-key` vers le même flux d'authentification par jeton.

## Requêtes compatibles Gemini

Pour les routes compatibles Gemini telles que `/v1beta/models/{model}:generateContent`, LLMoxy accepte :

```http
x-goog-api-key: <LLMOXY_API_KEY>
```

Il prend également en charge `?key=<LLMOXY_API_KEY>` pour la compatibilité avec les clients Gemini. Pour les intégrations côté serveur, utilisez les en-têtes pour éviter que les clés n'apparaissent dans les URL ou les journaux.

## WebSocket Realtime

Les clients WebSocket côté serveur peuvent utiliser les en-têtes d'authentification standard lors de la poignée de main. Les clients Realtime de style navigateur OpenAI peuvent transmettre la clé via le sous-protocole :

```txt
realtime, openai-insecure-api-key.<LLMOXY_API_KEY>, openai-beta.realtime-v1
```

## Contrôles de jeton

Les jetons peuvent être limités par le solde restant, la date d'expiration, les modèles disponibles, les groupes et la liste blanche IP. Lorsqu'un jeton expire, manque de solde, est désactivé ou que l'IP n'est pas autorisée, Relay renvoie une réponse d'erreur de style OpenAI.

Ceci est la version markdown de https://fr.llmoxy.com/docs/api-reference/authentication.
