Slutpunkten /v1/chat/completions
På denna sida
Uppdatering 2 november 2026 — Modeller. Mistral Large 3 (
mistral-large-2512) och Mistral Medium 3.5 avvecklades den 31 oktober 2026 och tas bort helt den 30 april 2027. Deras utsedda efterträdare, Mistral Large 4 (mistral-large-4), har funnits tillgänglig i offentlig förhandsversion sedan den 6 oktober. Exemplen i denna kurs använder aliasetmistral-large-latest, som för närvarande pekar på Mistral Large 3 enligt dess officiella specifikation (verifierad 3 november 2026). På samma sätt pekarmistral-medium-latestpå Mistral Medium 3.5. Dessa alias förblir giltiga fram till den 30 april 2027. För nya projekt bör du testamistral-large-4, deras utsedda efterträdare.
Din ingång till Mistral-modeller
Allt du gör med Mistral API går genom en enda sökväg: /v1/chat/completions. Detta är plattformens centrala nav som hanterar alla dina konversationsinteraktioner med språkmodeller. Oavsett om du bygger en intern supportchattbot, en extraherare som omvandlar PDF-fakturor till databasrader, eller en skrivassistent integrerad i ditt CMS, så anropar dessa tre till synes olika applikationer exakt samma slutpunkt med olika meddelanden och parametrar. Du behöver inte lära dig tre separata integrationer; du behöver bara bemästra en.
Från och med april 2026 hanterar denna slutpunkt miljardtals förfrågningar dagligen världen över. Att förstå dess struktur är det första steget för att utnyttja Mistral-modeller i produktion.
Bas-URL:en
Alla förfrågningar till Mistral API börjar från samma bas:
https://api.mistral.ai/v1/chat/completions
Du skickar en POST-förfrågan med en JSON-brödtext som innehåller dina meddelanden och parametrar, och API:t returnerar ett strukturerat JSON-svar. Det finns inga sessioner att öppna och inget server-side-tillstånd att underhålla: varje anrop är fristående.
Anatomin av en förfrågan
Det snabbaste sättet att verifiera att din nyckel fungerar är att skicka en minimal förfrågan med curl direkt från din 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?"}
]
}'
Två rubriker är obligatoriska: Content-Type: application/json beskriver formatet på förfrågningsbrödtexten, och Authorization: Bearer <din-nyckel> bär din autentisering. Själva brödtexten måste innehålla minst två fält: model, identifieraren för modellen som ska användas, och messages, arrayen som bär konversationen.
Python-motsvarighet med SDK
När du väl har passerat testfasen skriver ingen råa curl-kommandon i produktion. Det officiella SDK:t gör samma anrop på bara några rader:
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)
SDK:t hanterar rubriker, JSON-serialisering och svarsparsning åt dig. Det hanterar också automatiska försök vid tillfälliga fel, vilket sparar dig från att skriva egen logik för försök när en trafiktopp orsakar ett övergående fel.
Svarsstruktur
Oavsett hur du anropar API:t returnerar det alltid samma JSON-objekt:
{
"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
}
}
Tre fält förtjänar din omedelbara uppmärksamhet. choices är en array som innehåller de genererade svaren; det är här du hittar texten att visa för användaren. usage ger antalet tokens för inmatning, utmatning och totalt, vilket låter dig spåra den verkliga kostnaden för varje funktion snarare än att upptäcka fakturan i slutet av månaden. Slutligen förklarar finish_reason varför modellen stannade: stop för ett naturligt slut, length när tokengränsen kapade svaret, eller tool_calls när modellen begär verktygsexekvering. En sammanfattning som slutar mitt i en mening är nästan aldrig ett modellproblem; det är ett finish_reason på length som ingen läste.
Vanliga felkoder
När något går fel returnerar API:t standardiserade HTTP-koder:
- 400 — Felaktig förfrågan (ogiltig JSON, saknad parameter)
- 401 — Ogiltig eller saknad API-nyckel
- 429 — Hastighetsbegränsning nådd (för många förfrågningar)
- 500 — Serverfel (försök igen efter några sekunder)
I Python kastar SDK:t typade undantag som du kan fånga, vilket låter dig skilja mellan en utgången nyckel och tillfällig överbelastning, och reagera olika i varje fall:
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}")
Gör det till en vana att omsluta varje anrop med detta block från ditt allra första skript. Den dag din applikation körs obevakad kommer den att berätta vad som misslyckades istället för att tystna utan vidare.
Viktiga punkter
- Slutpunkten
/v1/chat/completionsär den enda som behövs för konversationsinteraktioner - Varje förfrågan kräver en
modeloch enmessages-array - Svaret innehåller alltid
choices,usageochfinish_reason - Python-SDK:t förenklar anrop avsevärt jämfört med
curl - Användningstokens låter dig beräkna dina kostnader exakt