Clés et adresse de l’API
MarkdownOù obtenir une clé, quelle adresse configurer dans les SDK et comment transmettre la clé.
Guide complet
Clé API
La clé se crée dans votre espace client sur ailoot.ai après l’inscription. 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).
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é |
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.
Variables d’environnement
Vous pouvez créer une seule variable et l’utiliser dans les paramètres de plusieurs programmes :
# ~/.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"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 compteVé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.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"