Končna točka /v1/chat/completions
Na tej strani
Posodobitev 2. november 2026 — Modeli. Mistral Large 3 (
mistral-large-2512) in Mistral Medium 3.5 sta bila 31. oktobra 2026 umaknjena iz uporabe (deprecated) in bosta dokončno ukinjena 30. aprila 2027. Njun naslednik, Mistral Large 4 (mistral-large-4), je v javnem predogledu od 6. oktobra. Primeri v tem tečaju uporabljajo aliasmistral-large-latest, ki trenutno kaže na Mistral Large 3 v skladu z njegovo uradno specifikacijo (preverjeno 3. novembra 2026). Podobnomistral-medium-latestkaže na Mistral Medium 3.5. Ti aliasi bodo veljavni do 30. aprila 2027. Za nove projekte preizkusitemistral-large-4, njunega naslednika.
Tvoj portal do modelov Mistral
Vse, kar počneš z API-jem Mistral, poteka skozi eno samo pot: /v1/chat/completions. To je osrednje središče platforme, ki obravnava vse tvoje pogovorne interakcije z jezikovnimi modeli. Ne glede na to, ali gradiš interno klepetalnico za podporo, ekstraktor, ki pretvarja račune v PDF v vrstice v zbirki podatkov, ali pomočnika za pisanje, integriranega v tvoj CMS, te tri navidez različne aplikacije kličejo popolnoma isto končno točko z različnimi sporočili in parametri. Ni ti treba spoznati treh ločenih integracij; obvladati moraš le eno.
Od aprila 2026 ta končna točka dnevno obdela milijarde zahtev po vsem svetu. Razumevanje njene strukture je prvi korak k izkoriščanju modelov Mistral v produkcijskem okolju.
Osnovni URL
Vse zahteve do API-ja Mistral se začnejo z isto osnovo:
https://api.mistral.ai/v1/chat/completions
Pošlješ zahtevo POST s telesom JSON, ki vsebuje tvoja sporočila in parametre, API pa vrne strukturiran odgovor JSON. Ni sej, ki bi jih bilo treba odpreti, in ni stanja na strani strežnika, ki bi ga bilo treba vzdrževati: vsak klic je samostojen.
Anatomija zahteve
Najhitrejši način za preverjanje, ali tvoj ključ deluje, je pošiljanje minimalne zahteve z uporabo curl neposredno iz tvoje terminalske okence:
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?"}
]
}'
Dve glavi sta obvezni: Content-Type: application/json opisuje obliko telesa zahteve, Authorization: Bearer <tvoj-ključ> pa prenaša tvojo avtentikacijo. Samo telo mora vsebovati vsaj dve polji: model, identifikator modela za uporabo, in messages, polje, ki nosi pogovor.
Ekvivalent v Pythonu s SDK-jem
Ko enkrat presežeš fazo testiranja, nihče v produkcijskem okolju ne piše surovih ukazov curl. Uradni SDK opravi isti klic v le nekaj vrsticah:
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 samodejno obravnava glave, serializacijo JSON in razčlenjevanje odgovora. Upravlja tudi samodejne ponovne poskuse za začasne napake, kar te rešuje pred pisanjem lastne logike za ponovne poskuse, ko vzrok za prehodno odpoved predstavlja skok v prometu.
Struktura odgovora
Ne glede na to, kako pokličeš API, vedno vrne isti objekt JSON:
{
"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
}
}
Tri polja si zaslužijo tvojo takojšnjo pozornost. choices je polje, ki vsebuje generirani odgovor(e); tu najdeš besedilo za prikaz uporabniku. usage zagotavlja število žetonov za vhod, izhod in skupno vsoto, kar ti omogoča sledenje dejanskim stroškom vsake funkcije, namesto da bi račun odkril šele ob koncu meseca. Nazadnje, finish_reason pojasni, zakaj se je model ustavil: stop za naravni konec, length, ko je omejitev žetonov prekinila odgovor, ali tool_calls, ko model zahteva izvajanje orodij. Povzetek, ki se konča sredi stavka, skoraj nikoli ni težava z modelom; gre za finish_reason z vrednostjo length, ki ga nihče ni prebral.
Pogoste kode napak
Ko gre kaj narobe, API vrne standardne kode HTTP:
- 400 — Nepravilno oblikovana zahteva (neveljaven JSON, manjkajoč parameter)
- 401 — Neveljaven ali manjkajoč ključ API
- 429 – Dosežena omejitev hitrosti (preveč zahtev)
- 500 – Napaka strežnika (ponovni poskus po nekaj sekundah)
V Pythonu SDK sproži tipizirane izjeme, ki jih lahko ujameš, kar ti omogoča razlikovanje med poteklim ključem in začasno zasičenostjo ter različno reakcijo v vsakem primeru:
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}")
Naj ti postane navada, da vsak klic oviješ v ta blok že od prvega skripta naprej. Ko bo tvoja aplikacija nekega dne delovala brez nadzora, ti bo sporočila, kaj je odpovedalo, namesto da bi tiho zastala.
Ključne ugotovitve
- Končna točka
/v1/chat/completionsje edina, potrebna za pogovorne interakcije - Vsaka zahteva zahteva
modelin poljemessages - Odgovor vedno vsebuje
choices,usageinfinish_reason - Python SDK bistveno poenostavi klice v primerjavi z
curl - Žetoni uporabe ti omogočajo natančen izračun stroškov