Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Gala punkts /v1/chat/completions

Nodarbība 1 no 16 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Tava izeja uz Mistral modeļiem
  2. Bāzes URL
  3. Pieprasījuma uzbūve
  4. Python ekvivalents, izmantojot SDK
  5. Atbildes struktūra
  6. Parastie kļūdu kodi
  7. Galvenās atziņas

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 alias mistral-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īgi mistral-medium-latest norā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ē.

1 gala punkts
Visām sarunām
POST
Viena HTTP metode
< 500 ms
Pirmā tokena latentums (straumēšana)
JSON
Ievades/izvades formāts

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/completions ir vienīgais, kas nepieciešams sarunu mijiedarbībām
  • Katrs pieprasījums prasa model un messages masīvu
  • Atbilde vienmēr satur choices, usage un finish_reason
  • Python SDK ievērojami vienkāršo izsaukumus salīdzinājumā ar curl
  • Lietojuma tokeni ļauj precīzi aprēķināt tavas izmaksas