Envoyer votre première requête API
Créez une clé API, installez le SDK et envoyez une requête de chat completion.
- Installer le SDK Python ou TypeScript
- Envoyer une requête à un modèle Mistral
- Afficher la réponse du modèle
Tout ce qui suit constitue la base des quickstarts agent et RAG qui suivent.
Temps nécessaire : ~5 minutes
Prérequis
Prérequis
- Python 3.9+ ou Node.js 18+ installé sur votre machine.
- Un compte Mistral AI. Créer un compte ↗
- Une clé API Mistral. Le plan Experiment est gratuit — aucune carte bancaire requise. Suivez le quickstart Activer Studio et générer une clé API si vous n'en avez pas encore.
Étape 1 : Obtenir votre clé API
Étape 1 : Obtenir votre clé API
- Ouvrez Studio›Clés API ↗.
- Cliquez sur Créer une nouvelle clé.
- Donnez un nom à la clé (par exemple,
quickstart) et cliquez sur Créer. - Copiez la clé dans votre presse-papiers. La clé n'apparaît qu'une seule fois ; si vous la perdez, générez-en une nouvelle.
- Définissez la clé comme variable d'environnement dans votre terminal :
export MISTRAL_API_KEY="your_api_key_here"Étape 2 : Installer le SDK
Étape 2 : Installer le SDK
pip install mistralaiÉtape 3 : Envoyer votre première requête
Étape 3 : Envoyer votre première requête
Créez un fichier et ajoutez le code suivant :
# quickstart.py
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "What is Mistral AI?"}
],
)
print(response.choices[0].message.content)Étape 4 : Exécuter le code
Étape 4 : Exécuter le code
python quickstart.pyVérification
Vérification
Le terminal affiche une brève description de Mistral AI. Si ce n'est pas le cas, consultez le tableau d'erreurs ci-dessous.
| Erreur | Cause | Solution |
|---|---|---|
401 Unauthorized | La clé API est incorrecte ou non définie | Exécutez echo $MISTRAL_API_KEY pour vérifier que la variable est définie |
402 Payment Required | Aucun moyen de paiement sur le compte | Ajoutez-en un sur Admin›Abonnements › Facturation ↗ |
429 Too Many Requests | Limite de débit atteinte | Attendez et réessayez avec un backoff exponentiel |
Et ensuite