Paraiméadair Iarratais
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026. Bunaithe ar thagairt API na bhFreagraí agus ar dhea-chleachtais xAI: teocht mholta 0.7, teoranta ag 1;
top_p0.95 mar réamhshocrú;max_output_tokensteoranta don fhreagra infheicthe (128,000 mar réamhshocrú, an réasúnaíocht eisiata); tá iarracht réasúnaíochta curtha in áirithe do grok-4.5 go 4.7. Foincí: API na bhFreagraí · Dea-chleachtais.
Iompar an mhúnla a rialú
Chomh maith le model, input, agus instructions, tairgeann API na bhFreagraí paraiméadair iomadúla chun iompar Grok a mhionchoigeartú. Trí na paraiméadair seo a thuiscint, is féidir leat freagraí níos ábhartha, níos giorra, nó níos cruthaithí a fháil ag brath ar do riachtanais.
Paraiméadair ghiniúna
temperature
Rialaíonn sé randamacht na bhfreagraí. Glacann an API le luachanna ó 0 go 2, ach sampláiltear aon rud os cionn 1 ag 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Tá dea-chleachtais xAI soiléir: socraigh temperature ar 0.7 agus ná téigh i bhfad uaidh, toisc go n-imíonn múnlaí Grok go dona le socruithe samplála eile. Chun tón níos fíriciúil nó níos cruthaithí a fháil, coigeartaigh an leid seachas an teocht.
top_p
Sampláil núicléis. Is é 0.95 an réamhshocrú do mhúnlaí téacs reatha, agus laghdaítear aon luach atá níos airde ná réamhshocrú an mhúnla chuige sin.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Le top_p: 0.95, ní mheasann an múnla ach na tokenanna a dhéanann suas 95% den dóchúlacht. Déanann an tagairt API an comhairle chlasaiceach a athrá nach gceart ach ceann amháin den dá pharaiméadar a choigeartú; éilíonn dea-chleachtais xAI ina ionad sin go socraítear an dá cheann go sainráite, ar 0.7 agus 0.95, ar gach iarratas.
max_output_tokens
Teoraíonn sé líon na tokenanna sa fhreagra infheicthe; ní áirítear réasúnaíocht ná glaonna feidhme, agus is é 128,000 token an luach réamhshocraithe:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
I gcás múnlaí réasúnaíochta, is é iarracht na réasúnaíochta, seachas an teorainn seo, a rialaíonn an machnamh inmheánach. Cuirtear in iúl freagra a ghearrtar de bharr na teorann le stádas incomplete.
reasoning
Do mhúnlaí a thacaíonn le réasúnaíocht, is féidir leat an iarracht a choigeartú:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Is iad low, medium, agus high (réamhshocrú) na luachanna féideartha, chomh maith le xhigh ar grok-4.6 agus grok-4.7; baineann an paraiméadar le grok-4.5 go 4.7, agus ní ghlacann grok-4.20-0309-reasoning leis. Úsáideann iarracht ard níos mó tokenanna agus oireann sé d’fhadhbanna casta.
Paraiméadair chomhrá
store
Cinneann sé an stóráiltear an fhreagra ar an taobh freastalaí:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: stóráiltear an fhreagra ar feadh 30 lá, in-aisghabhála trí GET, inúsáidte leprevious_response_idfalse: ní dhéantar an fhreagra a bhuanú (mód príobháideach)
previous_response_id
Nascann sé iarratas nua le comhrá atá ann cheana (mionsonraithe i gcacht 5).
user
Aitheantóir an úsáideora deiridh, úsáideach le haghaidh rianaithe agus measúnaithe:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Paraiméadair uirlisí
tools, tool_choice, parallel_tool_calls, max_turns
Rialaíonn na paraiméadair seo úsáid uirlisí (web_search, code_interpreter, feidhmeanna saincheaptha). Clúdaítear iad go mion sa chuid “Uirlisí” (ceachtanna 9-12).
Achoimre paraiméadar
| Paraiméadar | Cineál | Réamhshocrú | Úsáid |
|---|---|---|---|
model | teaghrán | riachtanach | Aitheantóir an mhúnla |
input | teaghrán/eagar | riachtanach | Leid an úsáideora |
instructions | teaghrán | null | Leid an chórais |
temperature | uimhir | — | 0.7 molta; teoranta ag 1 |
top_p | uimhir | 0.95 | Sampláil núicléis |
max_output_tokens | slánuimhir | 128,000 | Teorainn na freagra infheicthe |
reasoning | oibiacht | null | Iarracht réasúnaíochta |
store | boole | null | Buanú 30 lá |
stream | boole | false | Sruthú SSE |
user | teaghrán | null | Aitheantas an úsáideora deiridh |
Príomhphointí
- Molann xAI
temperatureag 0.7 agustop_pag 0.95, socraithe go sainráite - Ní theorannaíonn
max_output_tokensach an fhreagra infheicthe, gan an réasúnaíocht a áireamh - Coinníonn
store: truean fhreagra ar feadh 30 lá chun slabhrú comhrá a dhéanamh - Ligeann
reasoning.effortduit machnamh an mhúnla a scálú bunaithe ar chastacht na tasc - Cabhraíonn an paraiméadar
userle rianú agus measúnú ar thaobh xAI