Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Galutinis taškas /v1/chat/completions

Paskaita 1 iš 16 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Tavo vartai į „Mistral“ modelius
  2. Bazinis URL
  3. Užklausos anatomija
  4. Python ekvivalentas naudojant SDK
  5. Atsakymo struktūra
  6. Dažni klaidų kodai
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. — Modeliai. „Mistral Large 3“ (mistral-large-2512) ir „Mistral Medium 3.5“ buvo pasenę 2026 m. spalio 31 d. ir bus visiškai pašalinti 2027 m. balandžio 30 d. Jų įpėdinis, Mistral Large 4 (mistral-large-4), viešosios peržiūros etape yra nuo spalio 6 d. Šiame kurse naudojami pavyzdžiai remiasi aliasu mistral-large-latest, kuris šiuo metu nukreipia į „Mistral Large 3“ pagal jo oficialią specifikaciją (patikrinta 2026 m. lapkričio 3 d.). Panašiai mistral-medium-latest nukreipia į „Mistral Medium 3.5“. Šie aliasai galios iki 2027 m. balandžio 30 d. Naujiems projektams testuokite mistral-large-4 – jų numatytą įpėdinį.

Tavo vartai į „Mistral“ modelius

Viskas, ką darai su „Mistral“ API, eina vienu keliu: /v1/chat/completions. Tai centrinė platformos mazgas, tvarkantis visas tavo pokalbių sąveikas su kalbos modeliais. Nesvarbu, ar kuri vidinį palaikymo pokalbių robotą, ekstraktorių, kuris PDF sąskaitas paverčia duomenų bazės eilutėmis, ar rašymo asistentą, integruotą į tavo CMS – šios trys, iš pirmo žvilgsnio skirtingos, programos kviečia tą patį galutinį tašką, tik su skirtingais pranešimais ir parametrais. Tau nereikia mokytis trijų atskirų integracijų; pakanka įvaldyti vieną.

Nuo 2026 m. balandžio mėn. šis galutinis taškas visame pasaulyje kasdien apdoroja milijardus užklausų. Jo struktūros supratimas yra pirmas žingsnis norint naudoti „Mistral“ modelius gamyboje.

1 galutinis taškas
Visiems pokalbiams
POST
Vienas HTTP metodas
< 500 ms
Pirmojo žetono delsos laikas (srautinis)
JSON
Įvesties ir išvesties formatas

Bazinis URL

Visos užklausos „Mistral“ API prasideda tuo pačiu pagrindu:

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

Siunči POST užklausą su JSON kūnu, kuriame yra tavo pranešimai ir parametrai, o API grąžina struktūrizuotą JSON atsakymą. Nereikia atidaryti sesijų ar palaikyti serverio pusės būsenos: kiekvienas kvietimas yra savarankiškas.

Užklausos anatomija

Greičiausias būdas patikrinti, ar tavo raktas veikia – išsiųsti minimalią užklausą naudojant curl tiesiai iš terminalo:

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

Privalomos dvi antraštės: Content-Type: application/json apibūdina užklausos kūno formatą, o Authorization: Bearer <tavo-raktas> perduoda tavo autentifikavimo duomenis. Pats kūnas privalo turėti bent du laukus: model – naudojamo modelio identifikatorių, ir messages – masyvą, nešantį pokalbio istoriją.

Python ekvivalentas naudojant SDK

Kai pereini nuo testavimo fazės, niekas gamyboje nerašo žalių curl komandų. Oficialus SDK tą patį kvietimą atlieka vos keliomis eilutėmis:

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 už tave tvarko antraštes, JSON serializavimą ir atsakymų analizę. Jis taip pat automatiškai kartoja veiksmus laikinų klaidų atveju, taupydamas tave nuo savo paties kartojimo logikos rašymo, kai eismo šuolis sukelia trumpalaikį gedimą.

Atsakymo struktūra

Nesvarbu, kaip kvieti API, jis visada grąžina tą patį 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
  }
}

Trys laukai nusipelno tavo dėmesio iškart. choices yra masyvas, kuriame yra sugeneruotas (-i) atsakymas (-ai); būtent čia randi tekstą, kurį reikia rodyti naudotojui. usage pateikia žetonų skaičių įvestiai, išvestiai ir bendrą sumą, leisdamas stebėti tikrąją kiekvienos funkcijos kainą, o ne atrasti sąskaitą mėnesio pabaigoje. Galiausiai, finish_reason paaiškina, kodėl modelis sustojo: stop – natūrali pabaiga, length – kai atsakymą nutraukė žetonų limitas, arba tool_calls – kai modelis prašo įvykdyti įrankius. Santrauka, nutrūkusi sakinio viduryje, beveik niekada nėra modelio problema; tai finish_reason reikšmė length, kurios niekas neperskaitė.

Dažni klaidų kodai

Kai kas nors nepavyksta, API grąžina standartinius HTTP kodus:

  • 400 – Netvarkinga užklausa (neteisingas JSON, trūksta parametro)
  • 401 – Neteisingas arba trūkstamas API raktas
  • 429 – Pasiektas užklausų dažnio limitas (per daug užklausų)
  • 500 – Serverio klaida (pakartokite po kelių sekundžių)

Python kalboje SDK išmeta tipizuotas išimtis, kurias gali sugauti, leisdamas atskirti pasenusį raktą nuo laikino perkrovimo ir kiekvienu atveju reaguoti skirtingai:

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

Įprask kiekvieną kvietimą apgaubti šiuo bloku jau nuo pat pirmojo savo scenarijaus. Tą dieną, kai tavo programa veiks be priežiūros, ji tau pasakys, kas nepavyko, užuot tyliai sustojusi.

Svarbiausi punktai

  • Galutinis taškas /v1/chat/completions yra vienintelis, reikalingas pokalbių sąveikoms
  • Kiekviena užklausa reikalauja model ir messages masyvo
  • Atsakyme visada yra choices, usage ir finish_reason
  • Python SDK žymiai supaprastina kvietimus, lyginant su curl
  • Naudojimo žetonai leidžia tiksliai apskaičiuoti tavo išlaidas