Het /v1/chat/completions-eindpunt
Op deze pagina
Update 2 november 2026 — Modellen. Mistral Large 3 (
mistral-large-2512) en Mistral Medium 3.5 zijn op 31 oktober 2026 verouderd en worden op 30 april 2027 buiten gebruik gesteld. Hun aangewezen opvolger, Mistral Large 4 (mistral-large-4), is sinds 6 oktober beschikbaar in openbare preview. De voorbeelden in deze cursus gebruiken de aliasmistral-large-latest, die volgens de officiële specificatie momenteel wijst naar Mistral Large 3 (geverifieerd op 3 november 2026). Evenzo wijstmistral-medium-latestnaar Mistral Medium 3.5. Deze aliassen blijven geldig tot 30 april 2027. Test voor nieuwe projectenmistral-large-4, hun aangewezen opvolger.
Uw toegangspoort tot Mistral-modellen
Alles wat u doet met de Mistral API verloopt via één enkel pad: /v1/chat/completions. Dit is de centrale hub van het platform en behandelt al uw conversationele interacties met taalmodellen. Of u nu een interne supportchatbot bouwt, een extractor ontwikkelt die PDF-facturen omzet in databaserijen, of een schrijfassistent integreert in uw CMS: deze drie ogenschijnlijk verschillende toepassingen roepen exact hetzelfde eindpunt aan, slechts met andere berichten en parameters. U hoeft geen drie aparte integraties te leren; u hoeft er maar één onder de knie te krijgen.
Vanaf april 2026 verwerkt dit eindpunt wereldwijd miljarden verzoeken per dag. Inzicht in de structuur ervan is de eerste stap om Mistral-modellen succesvol in productie te gebruiken.
De basis-URL
Alle verzoeken aan de Mistral API vertrekken vanaf dezelfde basis:
https://api.mistral.ai/v1/chat/completions
U stuurt een POST-verzoek met een JSON-body die uw berichten en parameters bevat. De API retourneert een gestructureerd JSON-antwoord. Er zijn geen sessies die u hoeft te openen en geen server-side state die u hoeft bij te houden: elk verzoek is op zichzelf staand.
Anatomie van een verzoek
De snelste manier om te controleren of uw sleutel werkt, is door een minimaal verzoek te sturen met curl direct vanuit uw terminal:
curl https://api.mistral.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MISTRAL_API_KEY" \
-d '{
"model": "mistral-large-latest",
"messages": [
{"role": "user", "content": "Hello, how does your API work?"}
]
}'
Twee headers zijn verplicht: Content-Type: application/json beschrijft het formaat van de request-body en Authorization: Bearer <uw-sleutel> bevat uw authenticatie. De body zelf moet ten minste twee velden bevatten: model, de identifier van het te gebruiken model, en messages, de array die de conversatie draagt.
Python-equivalent met de SDK
Zodra u de testfase voorbij bent, schrijft niemand nog rauwe curl-commando’s in productie. De officiële SDK voert dezelfde aanroep uit in slechts een paar regels:
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": "Hello, how does your API work?"}
]
)
print(response.choices[0].message.content)
De SDK neemt het beheer van headers, JSON-serialisatie en het parseren van het antwoord voor u over. Daarnaast beheert hij automatische retries bij tijdelijke fouten, zodat u geen eigen retry-logica hoeft te schrijven wanneer een piek in het verkeer een tijdelijke storing veroorzaakt.
Structuur van het antwoord
Ongeacht hoe u de API aanroept, deze retourneert altijd hetzelfde JSON-object:
{
"id": "cmpl-abc123",
"object": "chat.completion",
"created": 1712150400,
"model": "mistral-large-latest",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! The Mistral API works..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 15,
"completion_tokens": 87,
"total_tokens": 102
}
}
Drie velden verdienen uw onmiddellijke aandacht. choices is een array die de gegenereerde antwoorden bevat; hier vindt u de tekst die u aan de gebruiker moet tonen. usage geeft het aantal tokens voor input, output en het totaal, zodat u de reële kosten van elke functie kunt volgen in plaats van de factuur pas aan het einde van de maand te ontdekken. Tot slot legt finish_reason uit waarom het model stopte: stop voor een natuurlijk einde, length wanneer de tokenlimiet het antwoord afsneed, of tool_calls wanneer het model uitvoering van tools aanvraagt. Een samenvatting die halverwege een zin eindigt, is bijna nooit een modelprobleem; het is een finish_reason van length die niemand heeft gelezen.
Veelvoorkomende foutcodes
Wanneer er iets misgaat, retourneert de API standaard HTTP-codes:
- 400 — Slecht gevormd verzoek (ongeldige JSON, ontbrekende parameter)
- 401 — Ongeldige of ontbrekende API-sleutel
- 429 — Ratiolimiet bereikt (te veel verzoeken)
- 500 — Serverfout (probeer het na enkele seconden opnieuw)
In Python werpt de SDK getypeerde uitzonderingen die u kunt afvangen. Hiermee kunt u onderscheid maken tussen een verlopen sleutel en tijdelijke overbelasting, en in elk geval anders reageren:
from mistralai.client import Mistral
from mistralai.client.errors import SDKError
client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))
try:
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Test"}]
)
except SDKError as e:
print(f"API Error: {e.status_code} — {e.message}")
Maak er een gewoonte van om elke aanroep vanaf uw allereerste script in dit blok te wikkelen. Op de dag dat uw applicatie onbeheerd draait, vertelt deze u wat er misging in plaats van stilzwijgend te stoppen.
Belangrijkste punten
- Het
/v1/chat/completions-eindpunt is het enige dat nodig is voor conversationele interacties - Elk verzoek vereist een
modelen eenmessages-array - Het antwoord bevat altijd
choices,usageenfinish_reason - De Python SDK vereenvoudigt aanroepen aanzienlijk ten opzichte van
curl - Usage-tokens stellen u in staat uw kosten nauwkeurig te berekenen