L-Endpoint /v1/chat/completions
F'din il-paġna
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-aliasmistral-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-latestjipponta lejn Mistral Medium 3.5. Dawn l-aliases se jibqgħu validi sal-30 ta’ April, 2027. Għal proġetti ġodda, ittestjamistral-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.
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/completionshuwa l-uniku meħtieġ għal interazzjonijiet konversazzjonali - Kull talba teħtieġ
modelu array ta’messages - It-tweġiba dejjem fiha
choices,usage, ufinish_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ż