Lõpp-punkt /v1/chat/completions
Sellel lehel
Uuendus 2. november 2026 — Mudelid. Mistral Large 3 (
mistral-large-2512) ja Mistral Medium 3.5 tunnistati 31. oktoobril 2026 aegunuks ja need lõpetatakse 30. aprillil 2027. Nende ametlik järeltulija, Mistral Large 4 (mistral-large-4), on olnud avalikus eelvaates alates 6. oktoobrist. Selles kursuses kasutatavad näited põhinevad aliasselmistral-large-latest, mis viitab praegu Mistral Large 3-le vastavalt selle ametlikule spetsifikatsioonile (kontrollitud 3. novembril 2026). Samuti viitab aliasmistral-medium-latestmudelile Mistral Medium 3.5. Need aliased kehtivad kuni 30. aprillini 2027. Uute projektide puhul testimistral-large-4, nende ametlikku järeltulijat.
Sinu värav Mistrali mudeliteni
Kõik, mida teed Mistrali API-ga, läbib ühte ja sama teed: /v1/chat/completions. See on platvormi keskpunkt, mis haldab kõiki sinu vestlussuhtlusi keelemudelitega. Kas ehitad sisemist tugichatbotti, ekstraktorit, mis teisendab PDF-arved andmebaasi ridadeks, või kirjutamisassistenti, mis on integreeritud sinu CMS-i – need kolm näiliselt erinevat rakendust kutsuvad täpselt sama lõpp-punkti, kasutades vaid erinevaid sõnumeid ja parameetreid. Sul pole vaja õppida kolme eraldi integratsiooni; piisab, kui valdad ühte.
Alates aprillist 2026 töötleb see lõpp-punkt maailmas miljardite kaupa päringuid iga päev. Selle struktuuri mõistmine on esimene samm Mistrali mudelite tootmises kasutamiseks.
Baas-URL
Kõik Mistrali API päringud algavad samast baasist:
https://api.mistral.ai/v1/chat/completions
Saadad POST-päringu JSON-kerega, mis sisaldab sinu sõnumeid ja parameetreid, ning API tagab struktureeritud JSON-vastuse. Seansse avada ega serveripoolset olekut hallata pole vaja: iga väljakutse on iseseisev.
Päringu anatoomia
Kiireim viis veenduda, et sinu võti töötab, on saata minimaalne päring, kasutades curl otse terminalist:
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?"}
]
}'
Kaks päist on kohustuslikud: Content-Type: application/json kirjeldab päringu keha formaati ja Authorization: Bearer <sinu-võti> edastab sinu autentimise. Keha ise peab sisaldama vähemalt kahte välja: model (kasutatava mudeli identifikaator) ja messages (vestlust kandev massiiv).
Pythoni ekvivalent SDK-ga
Kui testietapp on läbi, ei kirjuta keegi tootmises paljaid curl-käske. Ametlik SDK teeb sama väljakutse vaid mõne reaga:
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 haldab sinu eest päiseid, JSON-i jada- ja pöördteisendust ning vastuse parsimist. Samuti haldab see ajutiste vigade automaatset uuestiproovimist, säästes sind oma taaskäivitamisloogika kirjutamisest, kui liikluse tippkoormus põhjustab mööduva tõrke.
Vastuse struktuur
Sõltumata sellest, kuidas API-d kutsud, tagastab see alati sama JSON-objekti:
{
"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
}
}
Kolm välja väärivad sinu viivitamatut tähelepanu. choices on massiiv, mis sisaldab genereeritud vastus(t)eid; sealt leiad teksti, mida kasutajale kuvada. usage annab sisendi, väljundi ja kogusumma tokenite arvu, võimaldades sul jälgida iga funktsiooni tegelikku kulu, selle asemel et avastada arvet kuu lõpus. Lõpuks selgitab finish_reason, miks mudel peatus: stop loomuliku lõpu korral, length, kui tokenite piirang vastuse katkestas, või tool_calls, kui mudel taotleb tööriista käivitamist. Kokkuvõte, mis lõpeb keset lauset, pole peaaegu kunagi mudeli viga; see on finish_reason väärtus length, mida keegi ei lugenud.
Levinud veakoodid
Kui midagi läheb valesti, tagastab API standardsed HTTP-koodid:
- 400 — Vigane päring (vale JSON, puuduv parameeter)
- 401 — Vigane või puuduv API-võti
- 429 — Kiirusepiirang saavutatud (liiga palju päringuid)
- 500 — Serveriviga (proovi mõne sekundi pärast uuesti)
Pythonis tõstab SDK tüübitud erindeid, mida saad püüda, võimaldades eristada aegunud võtit ajutisest ülekoormusest ja reageerida igal juhul erinevalt:
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}")
Harjuta end iga väljakutse ümbritsemisel selle plokiga juba oma esimeses skriptis. Päeval, mil sinu rakendus töötab järelevalveta, ütleb see sulle, mis nurjus, selle asemel et vaikselt seiskuda.
Peamised punktid
- Lõpp-punkt
/v1/chat/completionson ainus, mida vestlussuhtluseks vaja on - Iga päring nõuab välja
modelja massiivimessages - Vastus sisaldab alati välju
choices,usagejafinish_reason - Pythoni SDK lihtsustab väljakutseid oluliselt võrreldes
curl-iga - Kasutatud tokenid võimaldavad sul oma kulusid täpselt arvutada