Roep Mistral aan vanuit je applicatie

Vóór je eerste verzoek

Maak een provider-API-sleutel aan in Mistral Studio. Bewaar deze op je server, nooit in een publieke repository of browserbundle. Controleer je account's modeltoegang en huidige tarieven. De inloggegevens van deze website zijn gescheiden van de provider.

cURL-snelstart

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
  }'

Python-voorbeeld

Installeer de officiële mistralai SDK uit je pakketregister en gebruik een omgevingsvariabele voor de sleutel.

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)

TypeScript-voorbeeld

Gebruik de officiële @mistralai/mistralai SDK op de server. Behandel ontbrekende keuzes en providerfouten voordat je een resultaat weergeeft.

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);

Streaming-antwoorden

Voor de HTTP API vraag je streaming aan en parseer je server-sent events stapsgewijs. Ga er niet van uit dat elk netwerkchunk één volledig event bevat. Bewaar gedeeltelijke tekst, ondersteun annulering en onderscheid een voltooid antwoord van een verbroken verbinding. Probeer alleen opnieuw wanneer je applicatie dit kan doen zonder neveneffecten te dupliceren.

Afbeeldingen en documenten

Volg de huidige API-referentie voor multimodale contentblokken. Gebruik geautoriseerde afbeeldingen en valideer publieke URL's. Bij documentvragen neem je bronpassages op en vraag je om expliciete verwijzingen. Splits grote invoer wanneer de verzoeklimiet van de provider lager is dan de gedocumenteerde context van het model.

Gestructureerde uitvoer en tools

Gebruik ondersteunde schema's voor gestructureerde uitvoer in plaats van te vragen om niet-gevalideerde JSON. Valideer argumenten voordat je tool-aanroepen uitvoert, handhaaf autorisatie op je server en beperk tool-lussen. Een door het model gegenereerde functie-aanroep is voorgestelde invoer, geen toestemming om een actie uit te voeren.

Productie-checklist

Stel uitvoerlimieten, time-outs en gelijktijdigheidsgrenzen in. Houd modelidentificaties, gebruik en fouten bij zonder geheimen of onnodige gebruikersinhoud te loggen. Test snelheidslimieten, gedeeltelijke streams, annulering en ongeldige tool-argumenten. Houd een provider-fallback en een kleine regressie-evaluatieset bij.

Beschikbaarheid in deze werkruimte

De bovenstaande integratie richt zich rechtstreeks op de officiële provider. Gebruik het werkruimte-account voor browserchat en creditbeheer. Directe API-voorbeelden vereisen je eigen provider-account en worden niet uitgevoerd vanuit dit artikel.