Parametri Bażiċi
F'din il-paġna
Ikkonfigura s-Sejħiet tal-API Tiegħek
Barra mill-kampijiet meħtieġa model u messages, l-API ta’ Chat Completions jaċċetta għadd żgħir ta’ parametri li jikkontrollaw l-imġiba tal-ġenerazzjoni. Dawn l-issettjar jagħmlu d-differenza bejn estrattur tad-data li jirritorna riżultati identiċi għall-istess fattura u ġeneratur ta’ slogans li qatt ma jirrepeti ruħu. Il-kodiċi tas-sejħa jibqa’ mingħajr bidla minn każ ta’ użu għall-ieħor; biss l-issettjar jinbidlu, u eżattament għalhekk għandek bżonn tifhem x’jagħmel kull wieħed minnhom.
Hawnhekk huma l-parametri li se tittratta kuljum, flimkien mat-tipi u l-valuri predefiniti tagħhom.
| Parametru | Tip | Predefinit | Deskrizzjoni |
|---|---|---|---|
model | string | — | Identifikatur tal-mudell (meħtieġ) |
messages | array | — | Array ta’ messaġġi (meħtieġ) |
max_tokens | integer | varjabbli | Numru massimu ta’ tokens tal-output |
temperature | float | 0.7 | Jikkontrolla l-kreattività (0.0 sa 1.5) |
top_p | float | 1.0 | Kampjunar tan-nukleu (0.0 sa 1.0) |
stream | boolean | false | Jattiva l-istreaming SSE |
safe_prompt | boolean | false | Jattiva l-gwardji tas-sigurtà |
Il-Parametru model
L-għażla tal-mudell tiegħek tiddetermina immedjatament il-kapaċitajiet, il-veloċità u l-ispiża ta’ kull sejħa—tliet kompromessi li ma tistax tirkupra mkien ieħor. Sa April 2026, il-mudelli primarji huma:
# Mudell ewlieni — raġunar kumpless, multilingwi
model = "mistral-large-latest"
# Mudell kompatt — mgħaġġel, ekonomiku, ideali għall-produzzjoni
model = "mistral-small-latest"
# Mudell żgħir ħafna — ultra-mgħaġġel, edge computing
model = "ministral-3b-latest"
# Mudell tal-kodiċi — speċjalizzat għall-ipprogrammar
model = "codestral-latest"
Is-suffiss -latest huwa konvenjenti waqt l-iżvilupp: dejjem jipponta lejn l-aħħar verżjoni mingħajr ma jeħtieġ bidliet fil-kodiċi. Madankollu, fil-produzzjoni, din il-konvenjenza ssir riskju, peress li aġġornament min-naħa ta’ Mistral jista’ jbiddel sottilment l-imġiba tal-applikazzjoni tiegħek. Ippreferi identifikaturi b’verżjoni bħal mistral-large-2512 biex tiggarantixxi r-riproduċibbiltà tat-testijiet tiegħek.
Il-Parametru max_tokens
Dan il-parametru jistabbilixxi l-limitu massimu tan-numru ta’ tokens li l-mudell jista’ jiġġenera fir-risposta tiegħu. Ma jfurzax lill-mudell biex jipproduċi eżattament dak in-numru; jiddefinixxi saqaf, xejn aktar.
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Summarize this text in one sentence."}],
max_tokens=100 # Ir-risposta ma taqbiżx 100 tokens
)
Jekk il-mudell jilħaq dan il-limitu, ir-risposta titqatta’ f’daqqa, u finish_reason tirritorna "length" minflok "stop". Din hija l-aktar kawża komuni ta’ risposti li jieqfu f’nofs sentenza, u ħadd ma jinnota sakemm jimmonitorja dan il-qasam. Ir-rifless it-tajjeb huwa li tikkalibra s-saqaf skont il-kompitu: il-klassifikazzjoni toqgħod f’10 sa 50 token peress li tistenna biss tikketta, sommarju jeħtieġ 200 sa 500 token, kitba ħielsa tieħu 1,000 sa 4,000, u l-ġenerazzjoni tal-kodiċi tilħaq faċilment 2,000 jew 8,000 token għax fajl sħiħ huwa twil.
Il-Parametru temperature
It-temperatura tikkontrolla l-grad ta’ każwalità fil-għażla tat-token. Aktar ma l-valur ikun baxx, aktar il-mudell isir deterministiku u prevedibbli; aktar ma jitla’, aktar jipprova kontinwazzjonijiet improbabbli. Għal mistoqsijiet fattwali, trid l-ewwel approċċ; għal eżerċizzji ta’ tismija, it-tieni.
# Temperatura baxxa — estrazzjoni, klassifikazzjoni, fattwali
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "What is the capital of France?"}],
temperature=0.1
)
# Temperatura għolja — kreattività, brainstorming
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Invent a name for an AI startup."}],
temperature=1.2
)
Il-firxa tvarja minn 0.0 sa 1.5. Tiddependix fuq temperature=0 għal determiniżmu perfett: varjazzjonijiet żgħar jibqgħu jeżistu minħabba r-rounding tal-floating-point fil-livell tal-hardware.
Il-Parametru top_p
Il-kampjunar tan-nukleu, jew Top P, jaġixxi fuq l-istess leva iżda permezz ta’ triq differenti: jillimita t-tokens kandidati b’soglia ta’ probabbiltà kumulattiva. B’top_p=0.5, biss it-tokens l-aktar probabbli li s-somom tal-probabbiltajiet tagħhom jilħqu 50% jibqgħu fil-kompetizzjoni; il-bqija jiġu skartati kompletament.
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Complete: The cat is on the..."}],
temperature=0.7,
top_p=0.9 # Iqis tokens li jkopru 90% tal-probabbiltà
)
Mistral jirrakkomanda li taġġusta parametru wieħed biss kull darba, jew it-temperatura jew top_p, qatt it-tnejn flimkien. Ir-raġuni hija prattika: jekk output isir stramb wara li tmexxi ż-żewġ sliders, xejn ma jgħidlek liema wieħed ikkawżah, u titlef kemm id-debuggability kif ukoll ir-riproduċibbiltà.
Eżempju Sħiħ bil-Parametri Kollha
Meta magħqudin f’sejħa waħda, dawn l-issettjar joħolqu ġeneratur ta’ slogans li huwa intenzjonalment qasir u ftit awdaċi, filwaqt li jsegwi wkoll il-konsum tat-tokens:
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": "system",
"content": "You are a concise and punchy marketing writer."
},
{
"role": "user",
"content": "Write a slogan for a meditation app."
}
],
max_tokens=50,
temperature=0.9,
top_p=1.0
)
print(response.choices[0].message.content)
print(f"Tokens used: {response.usage.total_tokens}")
Ħarrek dan l-iskritt tliet darbiet wara xulxin, imbagħad ibdel temperature=0.9 b’0.1 u ħarrehu tliet darbiet oħra. Id-differenza bejn iż-żewġ serje tgħallmek aktar dwar dan il-parametru milli kwalunkwe definizzjoni tista’ tagħmel.
Punti Ewlenin
modelumessageshuma l-uniki parametri meħtieġamax_tokenshuwa saqaf, mhux mira—iċċekkjafinish_reasonbiex tiskopri t-trunkazzjoni- Uża
temperaturebaxxa għal kompiti fattwali, għolja għall-kreattività top_pjirfina d-distribuzzjoni tat-token—taġġustahx fl-istess ħin mat-temperatura- Uża identifikaturi ta’ mudelli b’verżjoni fil-produzzjoni għar-riproduċibbiltà