Appeler Mistral depuis votre application

Avant votre première requête

Créez une clé API fournisseur dans Mistral Studio. Gardez-la sur votre serveur, jamais dans un dépôt public ou un bundle navigateur. Vérifiez l’accès aux modèles et les tarifs actuels de votre compte. Les identifiants de ce site web sont distincts de ceux du fournisseur.

Démarrage rapide avec cURL

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "messages": [{"role": "user", "content": "Explain idempotent retries."}],
    "max_tokens": 1024
  }'

Exemple Python

Installez le SDK officiel mistralai depuis votre registre de paquets et utilisez une variable d’environnement pour la clé.

import os
from mistralai import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
reply = client.chat.complete(
    model="mistral-large-4",
    messages=[{"role": "user", "content": "Explain idempotent retries."}],
    max_tokens=1024,
)
print(reply.choices[0].message.content)

Exemple TypeScript

Utilisez le SDK officiel @mistralai/mistralai sur le serveur. Gérez les choix manquants et les erreurs du fournisseur avant d’afficher un résultat.

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const reply = await client.chat.complete({
  model: "mistral-large-4",
  messages: [{ role: "user", content: "Explain idempotent retries." }],
  maxTokens: 1024,
});
console.log(reply.choices?.[0]?.message.content);

Réponses en streaming

Pour l’API HTTP, demandez le streaming et analysez les événements envoyés par le serveur de manière incrémentale. Ne supposez pas que chaque bloc réseau contient un événement complet. Préservez le texte partiel, prenez en charge l’annulation et distinguez une réponse terminée d’une connexion interrompue. Ne réessayez que si votre application peut le faire sans dupliquer les effets de bord.

Images et documents

Suivez la référence API actuelle pour les blocs de contenu multimodal. Utilisez des images autorisées et validez les URL publiques. Pour les questions sur des documents, incluez des passages sources et demandez des citations explicites. Divisez les entrées volumineuses lorsque la limite de requête du fournisseur est inférieure au contexte documenté du modèle.

Sorties structurées et outils

Utilisez les schémas de sortie structurée pris en charge plutôt que de demander du JSON non validé. Validez les arguments avant d’exécuter les appels d’outils, appliquez l’autorisation sur votre serveur et limitez les boucles d’outils. Un appel de fonction généré par le modèle est une entrée proposée, pas une permission d’agir.

Liste de contrôle pour la production

Définissez des limites de sortie, des délais d’attente et des limites de concurrence. Suivez les identifiants de modèle, l’utilisation et les erreurs sans journaliser de secrets ni de contenu utilisateur inutile. Testez les limites de débit, les flux partiels, l’annulation et les arguments d’outils mal formés. Gardez un fournisseur de secours et un petit ensemble d’évaluation de régression.

Disponibilité sur cet espace de travail

L’intégration ci-dessus cible directement le fournisseur officiel. Utilisez le compte de l’espace de travail pour le chat navigateur et la gestion des crédits. Les exemples d’API directe nécessitent votre propre compte fournisseur et ne s’exécutent pas depuis cet article.