Authentification
API-AI accepte l’en-tête Bearer façon OpenAI comme l’en-tête x-api-key façon Anthropic. Passez l’un ou l’autre, jamais les deux.
Formes d’en-tête
La passerelle normalise les deux en interne. Utilisez celui que votre SDK envoie déjà.
Authorization: Bearer mdf-... # OpenAI-style
x-api-key: mdf-... # Anthropic-styleVariables d’environnement
Nos exemples placent la clé dans API_AI_KEY. Les SDK lisent cependant par défaut leurs propres variables : exportez la clé sous ce nom, ou passez API_AI_KEY explicitement au constructeur. Le tableau ci-dessous indique ce que lit chaque outil :
| Client | Variable de la clé | Variable de l’URL de base |
|---|---|---|
| SDK Anthropic Python / Node | ANTHROPIC_API_KEY | ANTHROPIC_BASE_URL |
| SDK OpenAI Python / Node | OPENAI_API_KEY | OPENAI_BASE_URL ou OPENAI_API_BASE |
| CLI Claude Code | ANTHROPIC_API_KEY | ANTHROPIC_BASE_URL |
| Cursor | Settings → Models → API key | Settings → Models → Base URL |
| Roo Code | Réglages du fournisseur : Anthropic | Champ « Custom base URL » |
Vérifier l’authentification
Appelez /v1/models pour une vérification rapide et sans effet de bord :
curl -s https://api-ai.fr/v1/models \
-H "x-api-key: $API_AI_KEY" | jq '.data[].id'Une réponse réussie liste les modèles actuels. Une 401 ici signifie que la clé est mal formée, révoquée ou pas encore active.
Où conserver la clé
- Variables d’environnement — le choix par défaut dans la plupart des cas.
~/.zshrc/~/.bashrcavecHISTCONTROL=ignorespace, pour que les commandes précédées d’un espace n’aillent pas dans l’historique.- Gestionnaires de secrets : 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
- Fichiers
.envpar projet — toujours ajoutés au.gitignore.
Pièges courants
- Barre oblique finale.
https://api-ai.fr/v1/contrehttps://api-ai.fr/v1— certains SDK concatènent le chemin naïvement. Utilisez la forme sans barre finale ci-dessus. - Double Bearer.
Authorization: Bearer Bearer mdf-...arrive quand un outil ajoute déjàBeareret que vous le rajoutez. Retirez le préfixe dans votre configuration. - En-tête de version Anthropic. Ajoutez toujours
anthropic-version: 2023-06-01sur les appels HTTP bruts. Les SDK s’en chargent pour vous.
Renouveler une clé
Écrivez à support@minedom-france.fr depuis l’adresse email associée à votre achat. Le renouvellement est gratuit et immédiat : l’ancienne clé est révoquée dès l’émission de la nouvelle. Le solde est conservé.