Päringu parameetrid
Sellel lehel
Uuendatud 3. novembril 2026. Lähtudes Responses API dokumentatsioonist ja xAi parimatest tavadest: soovitatav temperatuur on 0,7 (maksimum 1);
top_pvaikeväärtusega 0,95;max_output_tokenspiirab ainult nähtavat vastust (vaikimisi 128 000, arutluskäik ei kuulu hulka); arutluse intensiivsus on reserveeritud mudelitele grok-4.5 kuni 4.7. Allikad: Responses API · Parimad tavad.
Mudeli käitumise juhtimine
Lisaks parameetritele model, input ja instructions pakub Responses API arvukalt võimalusi Groki käitumise täpseks häälestamiseks. Nende parameetrite mõistmine aitab sul saada oma vajadustest lähtuvalt asjakohasemaid, lühemaid või loovamaid vastuseid.
Generatsiooniparameetrid
temperature
Juhib vastuste juhuslikkust. API aktsepteerib väärtusi vahemikus 0 kuni 2, kuid kõik üle 1 olevad väärtused ümardatakse 1-ni.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
xAi parimad tavad on selged: sea temperature väärtuseks 0,7 ja ära kaldu sellest kaugele, sest Groki mudelid reageerivad teistele proovivõtuseadistustele halvasti. Faktilisema või loovama tooni saavutamiseks kohanda pigem sisendit (prompt) kui temperatuuri.
top_p
Tuumaproovivõtt (nucleus sampling). Praegused teksti mudelid kasutavad vaikeväärtusena 0,95 ja kõik mudeli vaikeseadistusest suuremad väärtused vähendatakse sellele tasemele.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Väärtusega top_p: 0.95 arvestab mudel ainult neid tokeneid, mis moodustavad 95% tõenäosusest. API dokumentatsioon kordab klassikalist nõuannet kohandada ainult üht kahest parameetrist, kuid xAi parimad tavad nõuavad mõlema parameetri igal päringul selget määramist väärtustele vastavalt 0,7 ja 0,95.
max_output_tokens
Piirab nähtavas vastuses olevate tokenite arvu; arutluskäik ja funktsioonikutsed ei kuulu sellesse piirangusse ning vaikeväärtus on 128 000 tokenit:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Arutlusvõimega mudelite puhul reguleerib sisemist mõtlemist pigem arutluse intensiivsus (reasoning effort) kui see piirang. Kui vastus katkeb piirangu tõttu, märgitakse see olekuga incomplete.
reasoning
Mudelite puhul, mis toetavad arutlemist, saad reguleerida pingutuse taset:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Võimalikud väärtused on low, medium ja high (vaikimisi), lisaks xhigh mudelite grok-4.6 ja grok-4.7 puhul; parameeter kehtib mudelitele grok-4.5 kuni 4.7, kuid grok-4.20-0309-reasoning seda ei aktsepteeri. Kõrge pingutustase tarbib rohkem tokeneid ja sobib keerukate ülesannete lahendamiseks.
Vestlusparameetrid
store
Määrab, kas vastust salvestatakse serveripoolselt:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: vastus salvestatakse 30 päevaks, seda saab kätte GET-päringuga ja kasutada koosprevious_response_id-gafalse: vastust ei salvestata (privaatne režiim)
previous_response_id
Seob uue päringu olemasoleva vestlusega (täpsemalt käsitletud 5. õppetükis).
user
Lõppkasutaja identifikaator, kasulik jälgimiseks ja modereerimiseks:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Tööriistade parameetrid
tools, tool_choice, parallel_tool_calls, max_turns
Need parameetrid kontrollivad tööriistade kasutamist (veebiotsing, koodi interpretaator, kohandatud funktsioonid). Neid käsitletakse üksikasjalikult jaos „Tööriistad“ (õppetükid 9–12).
Parameetrite kokkuvõte
| Parameeter | Tüüp | Vaikimisi | Kasutus |
|---|---|---|---|
model | string | nõutav | Mudeli identifikaator |
input | string/array | nõutav | Kasutaja sisend |
instructions | string | null | Süsteemi sisend |
temperature | number | — | Soovitatav 0,7; piiratud 1-ga |
top_p | number | 0.95 | Tuumaproovivõtt |
max_output_tokens | integer | 128,000 | Nähtava vastuse piirang |
reasoning | object | null | Arutluse intensiivsus |
store | boolean | null | 30-päevane säilitamine |
stream | boolean | false | SSE voogedastus |
user | string | null | Lõppkasutaja ID |
Peamised punktid
- xAi soovitab määrata
temperatureväärtuseks 0,7 jatop_pväärtuseks 0,95, mõlemad sõnaselgelt max_output_tokenspiirab ainult nähtavat vastust, jättes arutluskäigu väljastore: truesäilitab vastuse 30 päeva jooksul, võimaldades vestluse aheldamistreasoning.effortvõimaldab skaleerida mudeli mõtlemist vastavalt ülesande keerukusele- Parameeter
useraitab xAi poolt teha jälgimist ja modereerimist