Vous voulez brancher un assistant à votre application sans reconstruire toute l’infrastructure ? L’API Mistral permet généralement d’envoyer des messages à un modèle et de récupérer sa réponse, mais le choix du modèle et du format de requête change la suite. Une première requête peut tenir en quelques lignes ; la mise en production demande un peu plus de soin.

Une requête simple suffit pour démarrer, avec quelques choix à verrouiller
- Point d’entrée courant : l’endpoint Chat Completions reçoit une liste de messages et renvoie une réponse du modèle.
- Clé API : gardez-la dans une variable d’environnement, jamais dans le code envoyé au navigateur.
- Compatibilité OpenAI : elle existe, mais la documentation la signale comme étant en aperçu public.
- Coût estimé : il dépend du modèle et des tokens d’entrée comme de sortie.
- Erreurs fréquentes : une réponse 401 indique souvent une clé absente ou invalide ; une 429 signale une limite de requêtes atteinte.
L’API transforme une liste de messages en réponse exploitable
Imaginez un formulaire de support qui envoie la question d’un client à un modèle, puis affiche sa réponse dans votre application. L’API joue le rôle d’intermédiaire : votre programme transmet les messages, le modèle génère une sortie, puis votre code la récupère. Pour un échange textuel classique, l’endpoint POST /v1/chat/completions est le point de départ le plus direct.
La requête contient notamment un identifiant de modèle et des messages associés à des rôles comme user, assistant ou system. La réponse se trouve généralement dans choices[0].message.content, mais ce contenu peut aussi prendre la forme de blocs structurés, par exemple lorsqu’une fonctionnalité renvoie des appels d’outils. Je pense que cette distinction mérite d’être prévue dès le départ : un code qui suppose toujours recevoir une simple chaîne risque de casser quand le format de sortie change.
La documentation de Mistral sur les Chat Completions détaille les rôles de messages, la réponse et les options de compatibilité. Pour de la recherche sémantique, le besoin est différent : un endpoint d’embeddings transforme les textes en représentations numériques, au lieu de produire une réponse conversationnelle.
Votre première requête tient en quelques lignes de Python
Le démarrage se joue souvent sur un détail peu visible : la clé doit être disponible dans l’environnement où tourne le programme. La placer directement dans un fichier Python peut sembler pratique pendant un essai, mais elle risque alors de se retrouver dans un dépôt Git ou dans une image de déploiement.
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.chat.complete(
model="mistral-small-latest",
messages=[
{"role": "user", "content": "Résume ce texte en une phrase."}
],
)
print(response.choices[0].message.content)
Installez d’abord le SDK Python avec pip install mistralai, puis créez une clé dans Mistral Studio et définissez MISTRAL_API_KEY dans l’environnement d’exécution. La documentation de Mistral pour envoyer une première requête présente aussi des exemples en TypeScript et avec curl. À noter, le guide de démarrage indique que les paiements doivent être activés sur le compte pour utiliser les clés API.
Le modèle compatible OpenAI ne passe pas par la même URL
Vous avez déjà du code fondé sur le SDK OpenAI ? Il est possible de l’adapter à un endpoint compatible, en changeant l’URL de base et la clé, plutôt que de réécrire immédiatement toute l’intégration. Mais deux adresses proches ne signifient pas que les mêmes formats ou garanties s’appliquent.
| Votre situation | Ce que cela implique | Choix à faire |
|---|---|---|
| Vous utilisez le SDK Mistral | L’endpoint natif utilise le format Mistral. | Appelez https://api.mistral.ai/v1/chat/completions. |
| Vous réutilisez un client OpenAI | L’endpoint compatible utilise le format Chat Completions d’OpenAI et reste en aperçu public selon la documentation. | Configurez https://api.mistral.ai/openai/v1 comme URL de base, puis vérifiez les paramètres pris en charge par le modèle. |
| Vous avez besoin d’appels d’outils ou d’une sortie structurée | La prise en charge dépend du modèle et de la fonctionnalité appelée. | Testez le cas précis avant de figer l’intégration. |
La différence entre les deux endpoints est documentée par la documentation de compatibilité OpenAI de Mistral. Pour un nouveau projet, je choisirais le SDK natif si rien ne dépend déjà d’OpenAI ; pour un logiciel existant, je testerais d’abord le point de compatibilité, surtout si l’application utilise des outils ou des sorties structurées.
Le coût dépend du volume de tokens, pas du nombre de clics
Une conversation courte et une réponse longue ne consomment pas la même quantité de tokens. L’entrée comprend le texte transmis au modèle, tandis que la sortie correspond au texte généré ; les instructions système et l’historique ajoutent aussi des tokens à la requête.
À titre de repère, avec les tarifs affichés pour Mistral Small 4, un million de tokens d’entrée coûte 0,15 $ et un million de tokens de sortie 0,60 $. En supposant 10 000 requêtes comprenant chacune 800 tokens d’entrée et 300 tokens de sortie, l’estimation atteint 3 $ : 1,20 $ pour l’entrée et 1,80 $ pour la sortie. Ce calcul suppose que chaque requête reste dans ces volumes et n’inclut ni taxes ni conversion en euros.
Avec les mêmes volumes, le tarif affiché pour Mistral Large 4 donne une estimation de 11,90 $ : 5,60 $ pour les tokens d’entrée et 6,30 $ pour ceux de sortie. Cet écart ne suffit pas à choisir un modèle à l’aveugle : la qualité attendue, la latence et les fonctions nécessaires comptent aussi. Consultez la grille tarifaire de l’API Mistral avant de budgéter, car les prix et les modèles disponibles peuvent évoluer.
Une erreur 401 ou 429 appelle une vérification différente
Une requête qui échoue n’indique pas toujours un problème de code. Le statut HTTP donne déjà une piste utile : une erreur d’authentification se traite autrement qu’une limite de débit, et répéter la même requête sans diagnostic peut aggraver la situation.
| Situation | Cause probable | Que faire |
|---|---|---|
| 401 avec un message de clé invalide | La variable MISTRAL_API_KEY manque, est incomplète ou la clé a été révoquée. |
Vérifiez que la variable est définie dans le même terminal ou environnement que le programme, puis remplacez la clé si nécessaire. |
| 429 Too Many Requests | La limite de requêtes a été atteinte. | Réessayez après une attente progressive, avec un backoff exponentiel plutôt qu’une boucle de tentatives immédiates. |
| La réponse n’est pas une chaîne simple | La requête a pu produire des blocs de contenu ou des appels d’outils. | Inspectez la structure renvoyée et adaptez le traitement au type de sortie utilisé. |
Les causes et pistes de résolution des erreurs 401 et 429 figurent dans le guide officiel de première requête. Pour une application destinée à plusieurs personnes, ajoutez aussi des limites côté serveur et évitez de relancer automatiquement une demande qui échoue pour une raison permanente, comme une clé révoquée.
Avant le déploiement, gardez la clé hors du navigateur
Une clé intégrée au JavaScript d’une page web n’est pas secrète : toute personne qui charge la page peut la récupérer. Faites transiter les appels par votre serveur, conservez la clé dans un gestionnaire de secrets ou une variable d’environnement, et prévoyez une rotation si elle est exposée.
Pour démarrer sans compliquer le projet, gardez trois repères en tête : un endpoint adapté à votre client, un modèle choisi selon la tâche, puis un suivi des tokens consommés. Votre première requête peut rester minuscule ; c’est le contrôle de la clé, des réponses et des limites qui la rend fiable.