Clé API Mistral : créer, tester, payer

Pour obtenir une clé API Mistral, ouvrez la console Studio (console.mistral.ai), allez dans API Keys, cliquez sur New key, donnez un nom et une date d'expiration, choisissez la portée des connecteurs, puis copiez la clé : elle ne s'affiche qu'une fois. Il faut aussi un plan avec accès à l'API, donc une facturation activée. Voici le détail, d'après la documentation de Mistral AI lue le 15/11/2026.

Créer la clé dans le Studio

1. Ouvrez la console Studio et la page API Keys (console.mistral.ai/api-keys).
2. Sélectionnez New key.
3. Saisissez un Name qui identifie la clé, par exemple « quickstart » ou le nom de votre projet.
4. Fixez une date d'Expiration.
5. Choisissez l'accès aux connecteurs :
   • Shared connectors only : seulement les connecteurs partagés avec l'espace de travail ;
   • Private and shared connectors : vos connecteurs privés et ceux de l'espace de travail.
6. Créez la clé, copiez-la et rangez-la dans un gestionnaire de mots de passe ou un coffre à secrets.

La documentation est nette : la clé complète apparaît une seule fois et ne peut plus être récupérée une fois la fenêtre de confirmation fermée.

Activer la facturation : le point qui bloque souvent

Chez Mistral, les plans sont communs à Vibe, au Studio et à l'API. Le mode gratuit est l'état par défaut d'un nouveau compte ; selon la page « Limites et usage », il offre un budget mensuel pour Vibe et Studio, sans accès à l'API. Pour appeler l'API, il faut activer la facturation.

Le paiement à l'usage n'est pas un plan distinct : il est prépayé. L'organisation doit disposer de crédits, achetés ou obtenus par un code cadeau. Les plans payants (Pro, Team, Entreprise…) ajoutent une utilisation mensuelle incluse, partagée entre Studio, l'API et Vibe Code ; au-delà, la consommation est prise sur les crédits. Sans paiement à l'usage, l'utilisation peut s'arrêter jusqu'à la période de facturation suivante.

Où régler quoi, dans le panneau d'administration :

Tester la clé

Enregistrez la clé pour la session du terminal :

export MISTRAL_API_KEY="votre-clé"

Puis envoyez la requête de test donnée par la documentation :

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

La réponse du modèle se trouve dans choices[0].message.content. Si vous obtenez {"detail":"Invalid API Key"} avec un statut 401, la variable ne contient pas la clé complète dans ce terminal.

En Python, la documentation installe la bibliothèque mistralai et crée le client avec Mistral(api_key=os.environ["MISTRAL_API_KEY"]), puis appelle client.chat.complete(...). Le premier appel compare ce code à ceux de Claude et de Gemini.

Une clé, plusieurs adresses

La même clé sert sur l'adresse mondiale api.mistral.ai et sur les adresses régionales api.eu.mistral.ai et api.us.mistral.ai. L'adresse européenne fait tourner le modèle dans des centres de données de l'Union européenne et de l'AELE (Association européenne de libre-échange), avec un tarif majoré de 10 %. Les détails et les limites de ce choix sont sur la page API d'IA en Europe.

Bonnes habitudes dès le départ

• Une clé par projet et par environnement (test, production), avec une expiration.
• Une limite de dépense par espace de travail, pour qu'une boucle mal écrite ne vide pas les crédits.
• Jamais de clé dans le code envoyé au navigateur : voir protéger sa clé API.