Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Končna točka /v1/chat/completions

Lekcija 1 od 16 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Tvoj portal do modelov Mistral
  2. Osnovni URL
  3. Anatomija zahteve
  4. Ekvivalent v Pythonu s SDK-jem
  5. Struktura odgovora
  6. Pogoste kode napak
  7. Ključne ugotovitve

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 alias mistral-large-latest, ki trenutno kaže na Mistral Large 3 v skladu z njegovo uradno specifikacijo (preverjeno 3. novembra 2026). Podobno mistral-medium-latest kaže na Mistral Medium 3.5. Ti aliasi bodo veljavni do 30. aprila 2027. Za nove projekte preizkusite mistral-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.

1 končna točka
Za vse pogovore
POST
Ena sama metoda HTTP
< 500 ms
Latentnost prvega žetona (pretakanje)
JSON
Vhodno/izhodna oblika

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/completions je edina, potrebna za pogovorne interakcije
  • Vsaka zahteva zahteva model in polje messages
  • Odgovor vedno vsebuje choices, usage in finish_reason
  • Python SDK bistveno poenostavi klice v primerjavi z curl
  • Žetoni uporabe ti omogočajo natančen izračun stroškov