Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Krajnja točka /v1/chat/completions

Lekcija 1 od 16 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Tvoj ulaz u Mistralove modele
  2. Osnovni URL
  3. Anatomija zahtjeva
  4. Ekvivalent u Pythonu s SDK-om
  5. Struktura odgovora
  6. Uobičajene šifre pogrešaka
  7. Ključne točke

Ažuriranje 2. studenoga 2026. — Modeli. Mistral Large 3 (mistral-large-2512) i Mistral Medium 3.5 povučeni su iz upotrebe 31. listopada 2026., a bit će potpuno ukinuti 30. travnja 2027. Njihov nasljednik, Mistral Large 4 (mistral-large-4), dostupan je u javnoj pretpreglednoj verziji od 6. listopada. Primjeri u ovom tečaju koriste alias mistral-large-latest, koji trenutno pokazuje na Mistral Large 3 prema svojoj službenoj specifikaciji (provjereno 3. studenoga 2026.). Slično tome, mistral-medium-latest pokazuje na Mistral Medium 3.5. Ovi aliasi ostat će valjani do 30. travnja 2027. Za nove projekte testiraj mistral-large-4, njihovog namijenjenog nasljednika.

Tvoj ulaz u Mistralove modele

Sve što radiš s Mistral API-jem prolazi kroz jednu jedinu putanju: /v1/chat/completions. To je središnje čvorište platforme koje obrađuje sve tvoje konverzacijske interakcije s jezičnim modelima. Bilo da gradiš internog chatbota za podršku, ekstraktor koji pretvara PDF račune u retke baze podataka ili asistenta za pisanje integriranog u tvoj CMS, ove tri naizgled različite aplikacije pozivaju točno istu krajnju točku s različitim porukama i parametrima. Ne moraš učiti tri odvojene integracije; trebaš savladati samo jednu.

Od travnja 2026. ova krajnja točka dnevno obrađuje milijarde zahtjeva diljem svijeta. Razumijevanje njezine strukture prvi je korak za korištenje Mistralovih modela u proizvodnji.

1 krajnja točka
Za sve razgovore
POST
Jedna HTTP metoda
< 500 ms
Latencija prvog tokena (streaming)
JSON
Format ulaza/izlaza

Osnovni URL

Svi zahtjevi Mistral API-ju kreću od iste osnove:

https://api.mistral.ai/v1/chat/completions

Šalješ POST zahtjev s JSON tijelom koje sadrži tvoje poruke i parametre, a API vraća strukturirani JSON odgovor. Nema sesija za otvaranje niti stanja na strani poslužitelja koje treba održavati: svaki poziv je samostalan.

Anatomija zahtjeva

Najbrži način da provjeriš radi li tvoj ključ jest slanje minimalnog zahtjeva pomoću curl izravno iz tvog terminala:

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?"}
    ]
  }'

Dva zaglavlja su obavezna: Content-Type: application/json opisuje format tijela zahtjeva, a Authorization: Bearer <tvoj-ključ> prenosi tvoju autentifikaciju. Samo tijelo mora sadržavati najmanje dva polja: model, identifikator modela koji ćeš koristiti, i messages, niz koji nosi razgovor.

Ekvivalent u Pythonu s SDK-om

Kada prijeđeš fazu testiranja, nitko u proizvodnji ne piše sirove curl naredbe. Službeni SDK omogućuje isti poziv u samo nekoliko redaka:

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 umjesto tebe rukuje zaglavljima, serializacijom JSON-a i parsiranjem odgovora. Također upravlja automatskim ponovnim pokušajima za privremene pogreške, štedeći te pisanja vlastite logike za ponovne pokušaje kada skok prometa uzrokuje prolazni kvar.

Struktura odgovora

Bez obzira kako zoveš API, on uvijek vraća isti JSON objekt:

{
  "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 zaslužuju tvoju trenutnu pozornost. choices je niz koji sadrži generirani odgovor(e); ovdje pronalaziš tekst za prikaz korisniku. usage pruža broj tokena za ulaz, izlaz i ukupno, što ti omogućuje praćenje stvarnog troška svake značajke umjesto otkrivanja računa na kraju mjeseca. Konačno, finish_reason objašnjava zašto je model stao: stop za prirodni kraj, length kada je limit tokena prekinuo odgovor, ili tool_calls kada model zahtijeva izvršavanje alata. Sažetak koji završava usred rečenice gotovo nikada nije problem modela; to je finish_reason od length koji nitko nije pročitao.

Uobičajene šifre pogrešaka

Kada nešto pođe po zlu, API vraća standardne HTTP kodove:

  • 400 — Neispravan zahtjev (nevaljani JSON, nedostajući parametar)
  • 401 — Nevaljani ili nedostajući API ključ
  • 429 — Dosegnuto ograničenje stope (previše zahtjeva)
  • 500 — Pogreška poslužitelja (ponovi nakon nekoliko sekundi)

U Pythonu, SDK podiže tipizirane iznimke koje možeš uhvatiti, omogućujući ti razlikovanje između isteklog ključa i privremenog zasićenja, te različito reagiranje u svakom slučaju:

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}")

Učini navikom omotati svaki poziv u ovaj blok od svoje prve skripte. Dan kada tvoja aplikacija radi nenadzirano, reći će ti što je pošlo po zlu umjesto da tiho stane.

Ključne točke

  • Krajnja točka /v1/chat/completions jedina je potrebna za konverzacijske interakcije
  • Svaki zahtjev zahtijeva model i niz messages
  • Odgovor uvijek sadrži choices, usage i finish_reason
  • Python SDK značajno pojednostavljuje pozive u usporedbi s curl
  • Tokeni korištenja omogućuju ti precizan izračun tvojih troškova