Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Parametri zahtevka

Lekcija 3 od 16 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Nadzor obnašanja modela
  2. Parametri generiranja
  3. Parametri pogovora
  4. Parametri orodij
  5. Povzetek parametrov
  6. Ključne ugotovitve

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_p privzeto 0,95; max_output_tokens omejen 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 parametrom previous_response_id
  • false: 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

ParameterTipPrivzetoUporaba
modelstringzahtevanoIdentifikator modela
inputstring/arrayzahtevanoUporabniški poziv
instructionsstringnullSistemski poziv
temperaturenumber—Priporočeno 0,7; omejeno na 1
top_pnumber0.95Vzorčenje jedra
max_output_tokensinteger128.000Omejitev vidnega odgovora
reasoningobjectnullPrizadevanje za razmišljanje
storebooleannullTrajnost shranjevanja 30 dni
streambooleanfalsePretakanje SSE
userstringnullID končnega uporabnika

Ključne ugotovitve

  • xAI priporoča temperature 0,7 in top_p 0,95, oba nastavi izrecno
  • max_output_tokens omejuje le vidni odgovor, brez razmišljanja
  • store: true trajno shrani odgovor za 30 dni zaradi veriženja pogovorov
  • reasoning.effort ti omogoča prilagajanje intenzivnosti refleksije modela glede na zahtevnost naloge
  • Parameter user pomaga pri sledenju in moderiranju na strani xAI