Guide de démarrage : envoyer votre première requête API

Dans ce guide de démarrage, vous envoyez une requête de chat completion à un modèle Mistral et affichez sa réponse en Python, TypeScript ou curl. Comptez environ 5 minutes. Pour tout ce qu'accepte une requête de chat completion, consultez Chat completions.

• Une clé API Mistral, exportée en tant que MISTRAL_API_KEY. Pour en créer une, consultez Créer votre première clé API.
• Pour Python : Python 3.10 ou version ultérieure et uv.
• Pour TypeScript : Node.js et npm.
• Pour curl : rien d'autre.

Créez un projet et installez le SDK Mistral :

uv init first-request --python 3.12 && cd first-request
uv add mistralai

uv init first-request --python 3.12 && cd first-request
uv add mistralai

La requête spécifie un modèle et envoie un message utilisateur :

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": "In one sentence, what is an API key?"},
    ],
)

print(response.choices[0].message.content)

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": "In one sentence, what is an API key?"},
    ],
)

print(response.choices[0].message.content)

uv run quickstart.py

uv run quickstart.py

Une réponse en une seule phrase, affichée dans votre terminal. La formulation varie d'une exécution à l'autre :

An API key is a unique identifier used to authenticate and authorize access to an API.

An API key is a unique identifier used to authenticate and authorize access to an API.

Avec curl, la réponse correspond au champ content de choices[0].message dans la réponse JSON.

Si la requête échoue, vérifiez l'erreur :