Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-Endpoint /v1/chat/completions

Lezzjoni 1 / 16 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Il-Bieb tiegħek għall-Mudelli Mistral
  2. L-URL Bażi
  3. Anatomija ta’ Talba
  4. Ekwivalenti f’Python bl-SDK
  5. Struttura tat-Tweġiba
  6. Kodiċijiet ta’ Żball Komuni
  7. Punti Ewlenin

Aġġornament 2 ta’ Novembru, 2026 — Mudelli. Mistral Large 3 (mistral-large-2512) u Mistral Medium 3.5 ġew iddeprekati fil-31 ta’ Ottubru, 2026, u se jiġu rtirati fit-30 ta’ April, 2027. Is-suċċessur deżinjat tagħhom, Mistral Large 4 (mistral-large-4), ilu fil-preview pubblika mis-6 ta’ Ottubru. L-eżempji f’dan il-kors jużaw l-alias mistral-large-latest, li bħalissa jipponta lejn Mistral Large 3 skont l-ispeċifikazzjoni uffiċjali (ivverifikat fit-3 ta’ Novembru, 2026). Bl-istess mod, mistral-medium-latest jipponta lejn Mistral Medium 3.5. Dawn l-aliases se jibqgħu validi sal-30 ta’ April, 2027. Għal proġetti ġodda, ittestja mistral-large-4, is-suċċessur deżinjat tagħhom.

Il-Bieb tiegħek għall-Mudelli Mistral

Kull ma tagħmel bl-API ta’ Mistral jgħaddi minn mogħdija waħda: /v1/chat/completions. Dan huwa ċ-ċentru ewlieni tal-pjattaforma, li jimmaniġġja l-interazzjonijiet konversazzjonali kollha tiegħek mal-mudelli tal-lingwa. Kemm jekk qed tibni chatbot intern għas-sostenn, estrattur li jibdel fatturi PDF f’ringieli ta’ database, jew assistent tal-kitba integrat fis-CMS tiegħek, dawn it-tliet applikazzjonijiet li jidhru differenti sejħu l-istess endpoint eżatt b’messaġġi u parametri differenti. M’għandekx bżonn titgħallem tliet integrazzjonijiet separati; għandek biss tirrenja wieħed.

Sa April 2026, dan l-endpoint jimmaniġġja biljuni ta’ talbiet kuljum madwar id-dinja. Li tifhem l-istruttura tiegħu huwa l-ewwel pass biex tisfrutta l-mudelli Mistral fil-produzzjoni.

1 endpoint
Għall-konversazzjonijiet kollha
POST
Metodu HTTP wieħed
< 500 ms
Latenza tal-ewwel token (streaming)
JSON
Format tal-input/output

L-URL Bażi

It-talbiet kollha lill-API ta’ Mistral jibdew mill-istess bażi:

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

Tibgħat talba POST b’korp JSON li fih il-messaġġi u l-parametri tiegħek, u l-API tirritorna tweġiba JSON strutturata. M’hemm l-ebda sessjoni biex tiftaħ u l-ebda stat fuq is-server biex iżżomm: kull sejħa hija awtosuffiċjenti.

Anatomija ta’ Talba

L-aktar mod mgħaġġel biex tivverifika li ċ-ċavetta tiegħek taħdem huwa li tibgħat talba minima bl-użu ta’ curl direttament mit-terminal tiegħek:

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

Żewġ headers huma mandatorji: Content-Type: application/json jiddeskrivi l-format tal-korp tat-talba, u Authorization: Bearer <your-key> iġorr l-awtentikazzjoni tiegħek. Il-korp innifsu għandu jkun fih mill-inqas żewġ oqsma: model, l-identifikatur tal-mudell li għandu jintuża, u messages, l-array li jġorr il-konversazzjoni.

Ekwivalenti f’Python bl-SDK

Ladarba tgħaddi mill-fażi tal-ittestjar, ħadd ma jikteb kumandi curl raw fil-produzzjoni. L-SDK uffiċjali jagħmel l-istess sejħa f’ftit linji biss:

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)

L-SDK jimmaniġġja l-headers, is-serializzazzjoni JSON, u l-parsing tat-tweġiba għalik. Jimmaniġġja wkoll retries awtomatiċi għal żbalji temporanji, u jiffrankalek milli tikteb il-loġika tar-retry tiegħek meta tkun hemm żieda fit-traffiku li tikkawża falliment tranżitorju.

Struttura tat-Tweġiba

Kif tkun sejħt l-API, din dejjem tirritorna l-istess oġġett 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
  }
}

Tliet oqsma jistħoqqilhom l-attenzjoni immedjata tiegħek. choices huwa array li fih it-tweġiba/i ġġenerata/i; hawnhekk issib it-test biex turi lill-utent. usage jipprovdi l-għadd ta’ tokens għall-input, l-output, u t-total, u jippermettilek li ttraċċja l-ispiża reali ta’ kull karatteristika minflok ma tiskopri l-kont fl-aħħar tax-xahar. Fl-aħħar nett, finish_reason jispjega għaliex il-mudell waqaf: stop għal tmiem naturali, length meta l-limitu tat-tokens jaqta’ t-tweġiba, jew tool_calls meta l-mudell jitlob eżekuzzjoni ta’ għodda. Sommarju li jispiċċa f’nofs sentenza kważi qatt mhu problema tal-mudell; huwa finish_reason ta’ length li ħadd ma qara.

Kodiċijiet ta’ Żball Komuni

Meta xi ħaġa tmur ħażin, l-API tirritorna kodiċijiet HTTP standard:

  • 400 — Talba mħassra (JSON invalidu, parametru nieqes)
  • 401 — Ċavetta API invalida jew nieqsa
  • 429 — Limitu tar-rata milħuq (wisq talbiet)
  • 500 — Żball tas-server (ipprova mill-ġdid wara ftit sekondi)

F’Python, l-SDK iqajjem eċċezzjonijiet ittippjati li tista’ taqbad, u jippermettilek li tiddistingwi bejn ċavetta skaduta u saturazzjoni temporanja, u tirreaġixxi b’mod differenti f’kull każ:

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

Agħmilha drawwa li ddawwar kull sejħa f’dan il-blokk mill-ewwel skritt tiegħek. Il-jum li l-applikazzjoni tiegħek taħdem waħedha, tgħidlek x’falla minflok ma tieqaf silenzjużament.

Punti Ewlenin

  • L-endpoint /v1/chat/completions huwa l-uniku meħtieġ għal interazzjonijiet konversazzjonali
  • Kull talba teħtieġ model u array ta’ messages
  • It-tweġiba dejjem fiha choices, usage, u finish_reason
  • L-SDK ta’ Python jissimplifika s-sejħiet b’mod sinifikanti meta mqabbel ma’ curl
  • It-tokens tal-użu jippermettulek tikkalkula l-ispejjeż tiegħek b’mod preċiż