Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Lõpp-punkt /v1/chat/completions

Õppetund 1 / 16 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Sinu värav Mistrali mudeliteni
  2. Baas-URL
  3. Päringu anatoomia
  4. Pythoni ekvivalent SDK-ga
  5. Vastuse struktuur
  6. Levinud veakoodid
  7. Peamised punktid

Uuendus 2. november 2026 — Mudelid. Mistral Large 3 (mistral-large-2512) ja Mistral Medium 3.5 tunnistati 31. oktoobril 2026 aegunuks ja need lõpetatakse 30. aprillil 2027. Nende ametlik järeltulija, Mistral Large 4 (mistral-large-4), on olnud avalikus eelvaates alates 6. oktoobrist. Selles kursuses kasutatavad näited põhinevad aliassel mistral-large-latest, mis viitab praegu Mistral Large 3-le vastavalt selle ametlikule spetsifikatsioonile (kontrollitud 3. novembril 2026). Samuti viitab alias mistral-medium-latest mudelile Mistral Medium 3.5. Need aliased kehtivad kuni 30. aprillini 2027. Uute projektide puhul testi mistral-large-4, nende ametlikku järeltulijat.

Sinu värav Mistrali mudeliteni

Kõik, mida teed Mistrali API-ga, läbib ühte ja sama teed: /v1/chat/completions. See on platvormi keskpunkt, mis haldab kõiki sinu vestlussuhtlusi keelemudelitega. Kas ehitad sisemist tugichatbotti, ekstraktorit, mis teisendab PDF-arved andmebaasi ridadeks, või kirjutamisassistenti, mis on integreeritud sinu CMS-i – need kolm näiliselt erinevat rakendust kutsuvad täpselt sama lõpp-punkti, kasutades vaid erinevaid sõnumeid ja parameetreid. Sul pole vaja õppida kolme eraldi integratsiooni; piisab, kui valdad ühte.

Alates aprillist 2026 töötleb see lõpp-punkt maailmas miljardite kaupa päringuid iga päev. Selle struktuuri mõistmine on esimene samm Mistrali mudelite tootmises kasutamiseks.

1 lõpp-punkt
Kõigi vestluste jaoks
POST
Ainus HTTP-meetod
< 500 ms
Esimese tokeni latentsus (voogedastus)
JSON
Sisendi/väljundi formaat

Baas-URL

Kõik Mistrali API päringud algavad samast baasist:

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

Saadad POST-päringu JSON-kerega, mis sisaldab sinu sõnumeid ja parameetreid, ning API tagab struktureeritud JSON-vastuse. Seansse avada ega serveripoolset olekut hallata pole vaja: iga väljakutse on iseseisev.

Päringu anatoomia

Kiireim viis veenduda, et sinu võti töötab, on saata minimaalne päring, kasutades curl otse terminalist:

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

Kaks päist on kohustuslikud: Content-Type: application/json kirjeldab päringu keha formaati ja Authorization: Bearer <sinu-võti> edastab sinu autentimise. Keha ise peab sisaldama vähemalt kahte välja: model (kasutatava mudeli identifikaator) ja messages (vestlust kandev massiiv).

Pythoni ekvivalent SDK-ga

Kui testietapp on läbi, ei kirjuta keegi tootmises paljaid curl-käske. Ametlik SDK teeb sama väljakutse vaid mõne reaga:

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 haldab sinu eest päiseid, JSON-i jada- ja pöördteisendust ning vastuse parsimist. Samuti haldab see ajutiste vigade automaatset uuestiproovimist, säästes sind oma taaskäivitamisloogika kirjutamisest, kui liikluse tippkoormus põhjustab mööduva tõrke.

Vastuse struktuur

Sõltumata sellest, kuidas API-d kutsud, tagastab see alati sama JSON-objekti:

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

Kolm välja väärivad sinu viivitamatut tähelepanu. choices on massiiv, mis sisaldab genereeritud vastus(t)eid; sealt leiad teksti, mida kasutajale kuvada. usage annab sisendi, väljundi ja kogusumma tokenite arvu, võimaldades sul jälgida iga funktsiooni tegelikku kulu, selle asemel et avastada arvet kuu lõpus. Lõpuks selgitab finish_reason, miks mudel peatus: stop loomuliku lõpu korral, length, kui tokenite piirang vastuse katkestas, või tool_calls, kui mudel taotleb tööriista käivitamist. Kokkuvõte, mis lõpeb keset lauset, pole peaaegu kunagi mudeli viga; see on finish_reason väärtus length, mida keegi ei lugenud.

Levinud veakoodid

Kui midagi läheb valesti, tagastab API standardsed HTTP-koodid:

  • 400 — Vigane päring (vale JSON, puuduv parameeter)
  • 401 — Vigane või puuduv API-võti
  • 429 — Kiirusepiirang saavutatud (liiga palju päringuid)
  • 500 — Serveriviga (proovi mõne sekundi pärast uuesti)

Pythonis tõstab SDK tüübitud erindeid, mida saad püüda, võimaldades eristada aegunud võtit ajutisest ülekoormusest ja reageerida igal juhul erinevalt:

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

Harjuta end iga väljakutse ümbritsemisel selle plokiga juba oma esimeses skriptis. Päeval, mil sinu rakendus töötab järelevalveta, ütleb see sulle, mis nurjus, selle asemel et vaikselt seiskuda.

Peamised punktid

  • Lõpp-punkt /v1/chat/completions on ainus, mida vestlussuhtluseks vaja on
  • Iga päring nõuab välja model ja massiivi messages
  • Vastus sisaldab alati välju choices, usage ja finish_reason
  • Pythoni SDK lihtsustab väljakutseid oluliselt võrreldes curl-iga
  • Kasutatud tokenid võimaldavad sul oma kulusid täpselt arvutada