Clés API

Les clés API authentifient vos requêtes vers l'API Mistral. Chaque clé est limitée à un espace de travail spécifique et donne accès à tous les endpoints API disponibles dans votre plan.

Créer une clé API

Studio›Clés API ↗.
Cliquez sur Créez une nouvelle clé.
Vous pouvez aussi définir un nom (par exemple, "Production pipeline") et une date d'expiration.
Cliquez sur Créez une nouvelle clé.
Copiez la clé immédiatement.

Avertissement

La clé complète n'est affichée qu'une seule fois. Après avoir fermé la boîte de dialogue, vous ne pourrez pas la récupérer. Stockez la clé en toute sécurité dans un gestionnaire de mots de passe ou un coffre-fort de secrets. Ne la partagez pas et ne la committez pas dans le contrôle de version.

Utiliser les clés API

Transmettez la clé dans l'en-tête Authorization :

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral-medium-latest", "messages": [{"role": "user", "content": "Hello"}]}'

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "mistral-medium-latest", "messages": [{"role": "user", "content": "Hello"}]}'

Ou définissez-la comme variable d'environnement pour les SDK :

export MISTRAL_API_KEY="your-api-key"

export MISTRAL_API_KEY="your-api-key"

Portée de l'espace de travail

Les clés API sont limitées à l'espace de travail dans lequel elles ont été créées. Les ressources créées avec une clé (comme les jeux de données, les batch jobs, etc.) sont visibles par tous les membres de cet espace de travail.

Pour utiliser des clés différentes selon les environnements (développement, préproduction, production), créez des espaces de travail distincts.

Gestion des clés

Faites tourner les clés régulièrement. Créez une nouvelle clé, mettez à jour vos applications, puis supprimez l'ancienne.
Révoquez immédiatement les clés compromises en les supprimant de la page des clés API.
Définissez des dates d'expiration pour que les clés cessent automatiquement de fonctionner après une date donnée.
Suivi de l'utilisation : toute l'utilisation des clés dans un espace de travail est suivie ensemble et facturée à l'organisation.

Plans

Les clés API fonctionnent par défaut en mode Gratuit, avec des limites d'utilisation et de débit adaptées à l'évaluation et au prototypage. Pour augmenter vos limites avec la facturation à l'usage, passez au plan Scale dans Admin›Subscriptions › Billing ↗.