Authentification et clés API Admin
Authentifiez les requêtes auprès de l’API Admin avec une clé API Admin dédiée. Cette page explique comment ces clés fonctionnent et comment appeler l’API.
Clés API Admin
Une clé API Admin est créée et gérée dans le Backoffice (backoffice.mistral.ai ↗). Chaque clé est rattachée à une seule Organisation et donne accès aux endpoints d’administration de cette Organisation. Les clés sont gérées depuis le Backoffice du compte Enterprise pour plus de simplicité, mais leur périmètre reste toujours une seule Organisation. Pour comprendre le fonctionnement du Backoffice, consultez Comptes Enterprise et Backoffice.
Une clé API utilisateur standard ne donne jamais d’accès administrateur, quel que soit le rôle de l’utilisateur. Les endpoints d’administration nécessitent une clé API Admin créée dans le Backoffice. Elle est différente des clés API standard utilisées pour l’API d’inférence.
Créer une clé API Admin
- Ouvrez le Backoffice ↗ et accédez à
API keys. - Cliquez sur
Create key. - Choisissez un nom, sélectionnez l’Organisation à laquelle la clé appartient et, si nécessaire, définissez une date d’expiration.
- Copiez la clé et stockez-la en lieu sûr.
La clé est affichée uniquement lors de sa création. Si vous la perdez, vous devrez en créer une nouvelle.
Faire une requête
Envoyez les requêtes de l’API Admin à l’URL de base de l’API Admin et transmettez votre clé API Admin dans l’en-tête x-api-key.
- URL de base :
https://console.mistral.ai/api/admin - En-tête d’authentification :
x-api-key: <ADMIN_API_KEY>
Définissez la clé comme variable d’environnement avant d’envoyer des requêtes :
export ADMIN_API_KEY="your-admin-api-key"Envoyez ensuite une requête à un endpoint. Par exemple, pour lister les utilisateurs de l’Organisation rattachée à la clé :
curl "https://console.mistral.ai/api/admin/users?page=1&page_size=50" \
-H "x-api-key: $ADMIN_API_KEY"Pour les requêtes avec un corps JSON, incluez aussi l’en-tête Content-Type :
curl -X POST https://console.mistral.ai/api/admin/users-invite \
-H "x-api-key: $ADMIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "ada@example.com"}'Consultez la référence de l’API Admin pour les endpoints, paramètres et champs de réponse disponibles.