Gala punkts /v1/chat/completions
Šajā lapā
Atjauninājums 2026. gada 2. novembrī — Modeļi. Mistral Large 3 (
mistral-large-2512) un Mistral Medium 3.5 tika izslēgti no aprites 2026. gada 31. oktobrī, un to pilnīga izbeigšana paredzēta 2027. gada 30. aprīlī. To noteiktais pēctecis, Mistral Large 4 (mistral-large-4), kopš 6. oktobra ir publiskā priekšskatījumā. Šī kursa piemēros tiek izmantots aliasmistral-large-latest, kas saskaņā ar tā oficiālo specifikāciju pašlaik norāda uz Mistral Large 3 (pārbaudīts 2026. gada 3. novembrī). Līdzīgimistral-medium-latestnorāda uz Mistral Medium 3.5. Šie aliasi būs derīgi līdz 2027. gada 30. aprīlim. Jauniem projektiem testēmistral-large-4, kas ir to noteiktais pēctecis.
Tava izeja uz Mistral modeļiem
Viss, ko dari ar Mistral API, iet caur vienu ceļu: /v1/chat/completions. Šī ir platformas centrālā mezgls, kas apstrādā visas tavas sarunas ar valodu modeļiem. Neatkarīgi no tā, vai veido iekšēju atbalsta čatbotu, ekstraktoru, kas pārvērš PDF rēķinus datubāzes ierakstos, vai rakstīšanas asistentu, kas integrēts tavā CMS, šīs trīs šķietami atšķirīgās lietojumprogrammas izsauc tieši to pašu gala punktu, mainot tikai ziņojumus un parametrus. Tev nav jāapgūst trīs atsevišķas integrācijas; pietiek apgūt vienu.
Kopš 2026. gada aprīļa šis gala punkts visā pasaulē dienā apstrādā miljardiem pieprasījumu. Izpratne par tā struktūru ir pirmais solis, lai veiksmīgi izmantotu Mistral modeļus ražošanas vidē.
Bāzes URL
Visi pieprasījumi Mistral API sākas no vienas bāzes:
https://api.mistral.ai/v1/chat/completions
Tu nosūti POST pieprasījumu ar JSON ķermeni, kas satur tavus ziņojumus un parametrus, un API atgriež strukturētu JSON atbildi. Nav jāatver sesijas un jāsaglabā servera puses stāvoklis: katrs izsaukums ir pašpietiekams.
Pieprasījuma uzbūve
Ātrākais veids, kā pārbaudīt, vai tava atslēga darbojas, ir nosūtīt minimālu pieprasījumu, izmantojot curl tieši no terminaļa:
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?"}
]
}'
Divas galvenes ir obligātas: Content-Type: application/json apraksta pieprasījuma ķermeņa formātu, bet Authorization: Bearer <tava-atslēga> nodrošina autentifikāciju. Pašam ķermenim jābūt vismaz diviem laukiem: model — izmantojamā modeļa identifikators, un messages — masīvs, kas nes sarunu.
Python ekvivalents, izmantojot SDK
Tiklīdz esi pāris testēšanas posmu, neviens ražošanas vidē neraksta neapstrādātus curl komandrindas rīkojumus. Oficiālais SDK ļauj veikt to pašu izsaukumu tikai dažās rindās:
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 tavā vietā apstrādā galvenes, JSON serializāciju un atbildes parsēšanu. Tas arī automātiski veic atkārtotus mēģinājumu gadījumos, ja rodas pagaidu kļūdas, ietaupot tevi no savas atkārtotas izpildes loģikas rakstīšanas, kad satiksmes pieaugums izraisa pārejošu kļūmi.
Atbildes struktūra
Neatkarīgi no tā, kā izsauc API, tas vienmēr atgriež vienu un to pašu JSON objektu:
{
"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
}
}
Trīs laukiem jāpievērš tūlītēja uzmanība. choices ir masīvs, kas satur ģenerēto(-ās) atbildi(-es); tieši šeit atrodi tekstu, kas jāparāda lietotājam. usage sniedz tokena skaitu ievadei, izvadei un kopsummai, ļaujot tev izsekot katras funkcijas reālajām izmaksām, nevis uzzināt rēķinu mēneša beigās. Visbeidzot, finish_reason paskaidro, kāpēc modelis apstājās: stop dabiskam beigām, length, ja tokena limits pārtrauca atbildi, vai tool_calls, ja modelis pieprasa rīku izpildi. Kopsavilkums, kas beidzas teikuma vidū, gandrīz nekad nav modeļa problēma; tas ir finish_reason ar vērtību length, ko neviens nav izlasījis.
Parastie kļūdu kodi
Kad kaut kas noiet greizi, API atgriež standarta HTTP kodus:
- 400 — Nepareizi noformēts pieprasījums (nederīgs JSON, trūkstošs parametrs)
- 401 — Nederīga vai trūkstoša API atslēga
- 429 — Sasniegts ātruma ierobežojums (pārāk daudz pieprasījumu)
- 500 — Servera kļūda (atkārto pēc dažām sekundēm)
Python valodā SDK izraisa tipētas izņēmuma situācijas, kuras vari pārtvert, ļaujot atšķirt beigušos derīguma termiņu atslēgu no pagaidu pārslogotības un katrā gadījumā reaģēt atšķirīgi:
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}")
Padari par ieradumu katru izsaukumu ietvert šajā blokā jau no paša pirmā skripta. Dienā, kad tava lietojumprogramma darbosies bez uzraudzības, tā tev pateiks, kas neizdevās, nevis klusējot apstāsies.
Galvenās atziņas
- Gala punkts
/v1/chat/completionsir vienīgais, kas nepieciešams sarunu mijiedarbībām - Katrs pieprasījums prasa
modelunmessagesmasīvu - Atbilde vienmēr satur
choices,usageunfinish_reason - Python SDK ievērojami vienkāršo izsaukumus salīdzinājumā ar
curl - Lietojuma tokeni ļauj precīzi aprēķināt tavas izmaksas