Užklausos parametrai
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. Remiantis „Responses API“ nuorodomis ir „xAI“ geriausiomis praktikomis: rekomenduojama temperatūra 0,7 (ribota iki 1);
top_ppagal nutylėjimą 0,95;max_output_tokensribojamas tik matomam atsakymui (128 000 pagal nutylėjimą, samprotavimai neįskaičiuojami); samprotavimų pastangos skirtos tik „grok-4.5“–„4.7“ modeliams. Šaltiniai: Responses API · Geriausios praktikos.
Modelio elgsenos valdymas
Be model, input ir instructions, „Responses API“ siūlo daugybę parametrų, leidžiančių tiksliai sureguliuoti „Grok“ elgseną. Suprasdamas šiuos parametrus, gali gauti tikslesnius, trumpesnius ar kūrybiškesnius atsakymus, priklausomai nuo tavo poreikių.
Generavimo parametrai
temperature (temperatūra)
Valdo atsakymų atsitiktinumą. API priima reikšmes nuo 0 iki 2, tačiau viskas, kas viršija 1, imama kaip 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
„xAI“ geriausios praktikos yra aiškios: nustatyk temperature į 0,7 ir nuo jos nenukrypki, nes „Grok“ modeliai prastai reaguoja į kitus imties nustatymus. Jei nori faktiškesnio ar kūrybiškesnio tono, keisk užuominą (prompt), o ne temperatūrą.
top_p
Branduolio imtis (nucleus sampling). Dabartiniai teksto modeliai pagal nutylėjimą naudoja 0,95, o bet kokia reikšmė, didesnė už modelio numatytąją, sumažinama iki jos.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Nustačius top_p: 0.95, modelis atsižvelgia tik į tuos tokenus, kurie sudaro 95 % tikimybės. API nuorodoje kartojamas klasikinis patarimas keisti tik vieną iš dviejų parametrų, tačiau „xAI“ geriausios praktikos reikalauja kiekvienoje užklausoje aiškiai nustatyti abu: 0,7 ir 0,95.
max_output_tokens
Ribojama matomo atsakymo tokenų skaičius; samprotavimai ir funkcijų iškvietimai neįskaičiuojami, o numatytoji reikšmė yra 128 000 tokenų:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Samprotavimų modeliams vidinę refleksiją valdo ne ši riba, o samprotavimų pastangos (reasoning effort). Jei atsakymas nutraukiamas dėl šios ribos, gaunamas incomplete būsenos signalas.
reasoning (samprotavimas)
Modeliams, palaikantiems samprotavimus, gali reguliuoti pastangų lygį:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Galimos reikšmės: low, medium ir high (pagal nutylėjimą), taip pat xhigh modeliams „grok-4.6“ ir „grok-4.7“. Parametras taikomas „grok-4.5“–„4.7“ modeliams, o grok-4.20-0309-reasoning jo nepriima. Didelės pastangos sunaudoja daugiau tokenų ir tinka sudėtingoms užduotims.
Pokalbio parametrai
store (saugojimas)
Nustato, ar atsakymas saugomas serverio pusėje:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: atsakymas saugomas 30 dienų, jį galima gauti naudojant GET ir naudoti suprevious_response_idfalse: atsakymas neišsaugomas (privatus režimas)
previous_response_id
Susieja naują užklausą su esamu pokalbiu (išsamiau aptarta 5 pamokoje).
user (naudotojas)
Galutinio naudotojo identifikatorius, naudingas stebėsenai ir moderavimui:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Įrankių parametrai
tools, tool_choice, parallel_tool_calls, max_turns
Šie parametrai valdo įrankių naudojimą (web_search, code_interpreter, tinkintos funkcijos). Jie išsamiai aptariami skyriuje „Įrankiai“ (9–12 pamokos).
Parametrų santrauka
| Parametras | Tipas | Pagal nutylėjimą | Naudojimas |
|---|---|---|---|
model | string | required | Modelio identifikatorius |
input | string/array | required | Naudotojo užuomina |
instructions | string | null | Sistemos užuomina |
temperature | number | — | Rekomenduojama 0,7; ribojama iki 1 |
top_p | number | 0.95 | Branduolio imtis |
max_output_tokens | integer | 128,000 | Matomo atsakymo riba |
reasoning | object | null | Samprotavimų pastangos |
store | boolean | null | 30 dienų išsaugojimas |
stream | boolean | false | SSE srautinis perdavimas |
user | string | null | Galutinio naudotojo ID |
Svarbiausi punktai
- „xAI“ rekomenduoja nustatyti
temperatureį 0,7, otop_pį 0,95 ir tai daryti aiškiai max_output_tokensriboja tik matomą atsakymą, neįskaitant samprotavimųstore: trueišsaugo atsakymą 30 dienų pokalbių grandinei sudarytireasoning.effortleidžia keisti modelio refleksijos gylį pagal užduoties sudėtingumąuserparametras padeda „xAI“ vykdyti stebėseną ir moderavimą