Source: https://ailoot.ai/docs/fr-ch/keys/
Canonical: https://ailoot.ai/docs/fr-ch/keys/
Language: fr-ch

[Premiers pas](https://ailoot.ai/docs/fr-ch/) 

# Clés et adresse de l’API

[Markdown](https://ailoot.ai/docs/fr-ch/keys/index.md)

Où obtenir une clé, quelle adresse configurer dans les SDK et comment transmettre la clé.

## [](https://ailoot.ai/docs/fr-ch/keys/#key)Clé API

La clé se crée dans votre espace client sur [ailoot.ai](https://ailoot.ai) après [l’inscription](https://ailoot.ai/register). Elle ressemble à `sk-…`. Vous pouvez créer plusieurs clés, une pour votre poste de travail, une pour votre serveur et une par application, afin d’en révoquer une sans toucher aux autres.

Vous pouvez définir un plafond global de dépenses, une expiration, des listes d’IP autorisées et interdites, ainsi que des plafonds par fenêtre de 5 heures, 1 jour et 7 jours. Une restriction déclenche une erreur explicite : `api_key_quota_exhausted` (plafond global atteint), `usage_limit_reached` (fenêtre de dépenses de la clé épuisée ; attendez son renouvellement ou augmentez le plafond), `api_key_expired` ou `permission_denied` (par exemple, une requête depuis une IP non autorisée).

Ne publiez pas la clé dans du code, des dépôts ou des captures d’écran. Stockez-la dans une variable d’environnement ou un gestionnaire de secrets. En cas de fuite, supprimez-la dans votre espace client et créez-en une nouvelle.

## [](https://ailoot.ai/docs/fr-ch/keys/#base-url)Adresse de l’API

Règle principale : pour les clients compatibles OpenAI, l’adresse inclut `/v1`; pour Anthropic et Gemini, elle ne l’inclut pas.

| Client | Adresse de base | Destination de la requête |
| --- | --- | --- |
| SDK OpenAI et clients compatibles | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| SDK Anthropic, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| SDK Google GenAI, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| Le client demande l’adresse complète | `https://api.ailoot.ai/v1/chat/completions` | comme indiqué |

Une erreur 404 juste après la configuration ? L’adresse est presque toujours en cause : un `/v1` en trop ou manquant, un double slash ou `/chat/completions` lorsque le client l’ajoute lui-même.

## [](https://ailoot.ai/docs/fr-ch/keys/#auth)Comment transmettre la clé

Ailoot accepte la clé dans l’un des trois en-têtes : celui envoyé par votre SDK convient.

| En-tête | Clients utilisant cet en-tête |
| --- | --- |
| `Authorization: Bearer sk-…` | SDK OpenAI, la plupart des clients |
| `x-api-key: sk-…` | SDK Anthropic, Claude Code avec ANTHROPIC\_API\_KEY |
| `x-goog-api-key: sk-…` | SDK Google GenAI, Gemini CLI |

Sur les chemins `/v1/…` , une clé dans l’adresse (`?key=` ou `?api_key=`) n’est pas acceptée : la requête reçoit une erreur 400 avec le code `invalid_request` et un message indiquant que la clé est dans l’adresse. Elle ne se retrouve ainsi ni dans les journaux ni dans l’historique du navigateur. Si une clé a déjà été utilisée dans une adresse, il est préférable d’en créer une nouvelle.

Sur les chemins Gemini `/v1beta/…` , pour la compatibilité avec Google, le paramètre accepté est `?key=` — avec la priorité la plus basse, après les en-têtes. `?api_key=` est également refusé avec une erreur 400. Transmettre la clé dans l’en-tête reste plus fiable : `x-goog-api-key`.

## [](https://ailoot.ai/docs/fr-ch/keys/#env)Variables d’environnement

Vous pouvez créer une seule variable et l’utiliser dans les paramètres de plusieurs programmes :

```bash
# ~/.zshrc ou ~/.bashrc
export AILOOT_API_KEY="sk-..."

# Pour les programmes qui lisent les noms standard
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# Pour les programmes qui lisent les noms standard
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# Redémarrez le terminal pour que les variables soient prises en compte
```

## [](https://ailoot.ai/docs/fr-ch/keys/#check)Vérification de la clé

Le moyen le moins coûteux de vérifier une clé est de demander la liste des modèles : c’est gratuit.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à l’analyser.[Contacter l’assistance](mailto:support@ailoot.ai)

## Ailoot · L’entreprise et son portefeuille de projets





Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.





L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.





Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.