Parametri zahtevka
Na tej strani
Posodobljeno 3. novembra 2026. Na podlagi referenčne dokumentacije API-ja Responses in najboljših praks xAI: priporočena temperatura 0,7, omejena na 1;
top_pprivzeto 0,95;max_output_tokensomejen na vidni odgovor (privzeto 128.000, razmišljanje ni vključeno); prizadevanje za razmišljanje (reasoning effort) je rezervirano za modele grok-4.5 do 4.7. Viri: Responses API · Najboljše prakse.
Nadzor obnašanja modela
Poleg parametrov model, input in instructions API Responses ponuja številne dodatne parametre za fino prilagajanje obnašanja Groka. Razumevanje teh parametrov ti omogoča, da glede na svoje potrebe pridobiš bolj relevantne, krajše ali bolj ustvarjalne odgovore.
Parametri generiranja
temperature
Krmili naključnost odgovorov. API sprejema vrednosti od 0 do 2, vendar se vse vrednosti nad 1 vzorčijo kot 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Najboljše prakse xAI so jasne: nastavi temperature na 0,7 in se od te vrednosti ne oddaljuj preveč, saj modeli Grok slabo reagirajo na druge nastavitve vzorčenja. Za bolj dejanski ali ustvarjalen ton prilagodi poziv (prompt), ne temperature.
top_p
Vzorčenje jedra (nucleus sampling). Trenutni besedilni modeli imajo privzeto vrednost 0,95; vsaka vrednost, višja od privzete vrednosti modela, se zmanjša na to mejo.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Pri top_p: 0.95 model upošteva le žetone, ki predstavljajo 95 % verjetnosti. Referenčna dokumentacija API-ja ponavlja klasičen nasvet, da prilagodiš le enega od obeh parametrov, medtem ko najboljše prakse xAI zahtevajo, da oba parametra pri vsakem zahtevku izrecno nastaviš na 0,7 oziroma 0,95.
max_output_tokens
Omeji število žetonov v vidnem odgovoru; razmišljanje in klici funkcij se ne štejejo, privzeta vrednost pa znaša 128.000 žetonov:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Pri modelih za razmišljanje notranjo refleksijo krmili prizadevanje za razmišljanje (reasoning effort), ne ta omejitev. Če je odgovor prekinjen zaradi te omejitve, to signalizira stanje incomplete.
reasoning
Pri modelih, ki podpirajo razmišljanje, lahko prilagodiš prizadevanje:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Možne vrednosti so low, medium in high (privzeto), poleg xhigh pri modelih grok-4.6 in grok-4.7; parameter velja za modele grok-4.5 do 4.7, model grok-4.20-0309-reasoning pa ga ne sprejme. Visoko prizadevanje porabi več žetonov in je primerno za kompleksne probleme.
Parametri pogovora
store
Določa, ali je odgovor shranjen na strežniški strani:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: odgovor je shranjen za 30 dni, pridobljiv prek GET, uporaben s parametromprevious_response_idfalse: odgovor ni trajno shranjen (način zasebnosti)
previous_response_id
Poveže nov zahtevek z obstoječim pogovorom (podrobneje obravnavano v lekciji 5).
user
Identifikator končnega uporabnika, uporaben za sledenje in moderiranje:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametri orodij
tools, tool_choice, parallel_tool_calls, max_turns
Ti parametri krmilijo uporabo orodij (web_search, code_interpreter, funkcije po meri). Podrobno so obravnavani v razdelku „Orodja” (lekcije 9–12).
Povzetek parametrov
| Parameter | Tip | Privzeto | Uporaba |
|---|---|---|---|
model | string | zahtevano | Identifikator modela |
input | string/array | zahtevano | Uporabniški poziv |
instructions | string | null | Sistemski poziv |
temperature | number | — | Priporočeno 0,7; omejeno na 1 |
top_p | number | 0.95 | Vzorčenje jedra |
max_output_tokens | integer | 128.000 | Omejitev vidnega odgovora |
reasoning | object | null | Prizadevanje za razmišljanje |
store | boolean | null | Trajnost shranjevanja 30 dni |
stream | boolean | false | Pretakanje SSE |
user | string | null | ID končnega uporabnika |
Ključne ugotovitve
- xAI priporoča
temperature0,7 intop_p0,95, oba nastavi izrecno max_output_tokensomejuje le vidni odgovor, brez razmišljanjastore: truetrajno shrani odgovor za 30 dni zaradi veriženja pogovorovreasoning.effortti omogoča prilagajanje intenzivnosti refleksije modela glede na zahtevnost naloge- Parameter
userpomaga pri sledenju in moderiranju na strani xAI