Paraiméadair Bhunúsacha
Ar an leathanach seo
Cumraigh do Ghlaonna API
Chomh maith leis na réimsí éigeantacha model agus messages, glacadh le roinnt paraiméadar breise sa Chat Completions API a rialaíonn iompar na ginearála. Is iad na socruithe seo a dhéanann idirdhealú idir eastóscóir sonraí a thugann torthaí comhionanna don chéad chuntas céanna agus gineadóir slogain nach ndéanann athrá riamh. Fanann an cód glaonna gan athrú ó chás úsáide amháin go dtí an chéad cheann eile; níl ann ach na socruithe a athrú, agus sin díreach an fáth a gcaithfidh tú a thuiscint cad a dhéanann gach ceann acu.
Seo na paraiméadair a láimhseálfaidh tú go laethúil, mar aon lena gcineálacha agus a luachanna réamhshocraithe.
| Paraiméadar | Cineál | Réamhshocrú | Cur síos |
|---|---|---|---|
model | string | — | Aitheantóir an mhúnla (éigeantach) |
messages | array | — | Eagar teachtaireachtaí (éigeantach) |
max_tokens | integer | athraitheach | Uasmhéid tócan aschuir |
temperature | float | 0.7 | Rialaíonn cruthaitheacht (0.0 go 1.5) |
top_p | float | 1.0 | Sampláil núicléasach (0.0 go 1.0) |
stream | boolean | false | Cumasaíonn sruthú SSE |
safe_prompt | boolean | false | Cumasaíonn gardaí sábháilteachta |
An Paraiméadar model
Cinneann do rogha múnla láithreach cumais, luas agus costas gach glaonna—trí chomhréiteach nach féidir leat a aisghabháil in áit ar bith eile. Ó Aibreán 2026 i leith, seo iad na príomh-mhúnlaí:
# Múnla bratach — réasúnaíocht chasta, ilteangach
model = "mistral-large-latest"
# Múnla dlúth — tapa, eacnamaíoch, idéalach don táirgeadh
model = "mistral-small-latest"
# Múnla bídeach — thar a bheith tapa, ríomhaireacht imeallach
model = "ministral-3b-latest"
# Múnla cóid — speisialaithe don chlárú
model = "codestral-latest"
Tá an iarmhír -latest áisiúil le linn forbartha: díreoidh sé i gcónaí ar an leagan is nua gan aon athrú cód a éileamh. Sa táirgeadh, áfach, éiríonn an áisiúlacht seo ina riosca, toisc gur féidir le nuashonrú ó thaobh Mistral de iompar d’iarratais a athrú go subtle. Is fearr aitheantóirí leaganaithe cosúil le mistral-large-2512 a úsáid chun in-atáirgeadh do thástálacha a ráthú.
An Paraiméadar max_tokens
Socraíonn an paraiméadar seo an teorainn uasta ar líon na dtócan is féidir leis an múnla a ghiniúint ina fhreagra. Ní chuireann sé iallach ar an múnla an líon sin go díreach a tháirgeadh; sainíonn sé uasteorainn, ní haon rud eile.
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Déan achoimre ar an téacs seo in aon abairt amháin."}],
max_tokens=100 # Ní sháróidh an freagra 100 tócan
)
Má bhuaileann an múnla an teorainn seo, gearrtar an freagra go tobann, agus filleann finish_reason "length" in ionad "stop". Is é seo an chúis is coitianta le freagraí a stopann i lár abairte, agus ní thugann aon duine faoi deara é go dtí go ndéanann siad monatóireacht ar an réimse seo. Is é an freagairt cheart ná an uasteorainn a chalabrú de réir na tasc: oireann aicmiú laistigh de 10 go 50 tócan ós rud é nach bhfuil tú ag súil ach le lipéad, teastaíonn 200 go 500 tócan d’achoimre, glacann scríbhneoireacht saorchruthach 1,000 go 4,000, agus sroicheann giniúint cóid 2,000 nó 8,000 tócan go héasca toisc go bhfuil comhad iomlán fada.
An Paraiméadar temperature
Rialaíonn an teocht an méid randamachta i roghnú na dtócan. Dá ísle an luach, is ea is cinntí agus is intuartha a éiríonn an múnla; dá airde a théann sé, is ea is mó a dhéanann sé iarracht leanúint neamhdhóchúla. Do cheisteanna fíriciúla, ba mhaith leat an cur chuige sin; do chleachtaí ainmniúcháin, an ceann eile.
# Teocht íseal — eastóscadh, aicmiú, fíricí
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Cé í príomhchathair na Fraince?"}],
temperature=0.1
)
# Teocht ard — cruthaitheacht, brainstoirmeoireacht
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Invent a name for an AI startup."}],
temperature=1.2
)
Síneann an raon ó 0.0 go 1.5. Ná bíodh muinín agat as temperature=0 le haghaidh cinnteachta foirfe: leanann athruithe beaga ann mar gheall ar shlánú snámhphointe ar leibhéal an chrua-earraí.
An Paraiméadar top_p
Feidhmíonn sampláil núicléasach, nó Top P, ar an luamhán céanna ach trí bhealach difriúil: cuireann sé teorainn le tócan iarrthóra de réir tairsí dóchúlachta carnathaí. Le top_p=0.5, ní fhanann ach na tócan is dóichí a shroicheann a ndóchúlachtaí suimithe 50% san iomaíocht; caitear an chuid eile amach go hiomlán.
response = client.chat.complete(
model="mistral-large-latest",
messages=[{"role": "user", "content": "Críochnaigh: Tá an cat ar an..."}],
temperature=0.7,
top_p=0.9 # Breithníonn sé tócan a chlúdaíonn 90% den dóchúlacht
)
Molann Mistral gan ach paraiméadar amháin a choigeartú ag an am, cibé acu temperature nó top_p, ach riamh an dá cheann le chéile. Is praiticiúil an fáth: má éiríonn aschur aisteach tar éis an dá shleamhnán a bhogadh, ní insíonn aon rud duit cé acu ceann a d’fhág é sin, agus cailleann tú an dá rud: in-dífhabhtú agus in-atáirgeadh.
Sampla Iomlán le Gach Paraiméadar
Nuair a chumascfar na socruithe seo i nglaon amháin, cruthaíonn siad gineadóir slogain atá d’aon ghairre gairid agus beagán dána, agus é ag rianú tomhaltas tócan ag an am céanna:
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": "Is scríbhneoir margaíochta gonta agus buailte tú."
},
{
"role": "user",
"content": "Scríobh slogan d'aip machnaimh."
}
],
max_tokens=50,
temperature=0.9,
top_p=1.0
)
print(response.choices[0].message.content)
print(f"Tokens used: {response.usage.total_tokens}")
Rith an script seo trí huaire as a chéile, ansin cuir temperature=0.1 in ionad temperature=0.9 agus rith é trí huaire eile. Múinfidh an difríocht idir an dá shraith níos mó duit faoin bparaiméadar seo ná mar a d’fhéadfadh aon sainmhíniú a dhéanamh.
Príomhphointí
- Ní paraiméadair éigeantacha ach
modelagusmessages - Is uasteorainn, ní sprioc, é
max_tokens—seiceáilfinish_reasonchun gearradh a bhrath - Úsáid
temperatureíseal do thascanna fíriciúla, ard do chruthaitheacht - Déanann
top_pscagadh ar dháileadh tócan—ná coigeartaigh é ag an am céanna letemperature - Úsáid aitheantóirí múnla leaganaithe sa táirgeadh le haghaidh in-atáirgeachta