Pieprasījuma parametri
Šajā lapā
Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz Responses API atsauces dokumentāciju un xAI labākās prakses ieteikumiem: ieteicamā temperatūra ir 0,7 (maksimāli 1);
top_ppēc noklusējuma ir 0,95;max_output_tokensattiecas tikai uz redzamo atbildi (noklusējums 128 000, spriešana netiek ieskaitīta); spriešanas intensitāte (reasoning effort) ir pieejama tikai modeļiem no grok-4.5 līdz 4.7. Avoti: Responses API · Labākā prakse.
Modeļa uzvedības vadība
Papildus parametriem model, input un instructions, Responses API piedāvā daudzus citus parametrus, lai precīzi pielāgotu Grok uzvedību. Izprotot šos parametrus, tu vari iegūt atbildes, kas ir atbilstošākas, īsākas vai radošākas atkarībā no tavām vajadzībām.
Ģenerēšanas parametri
temperature (temperatūra)
Kontrolē atbilžu nejaušības pakāpi. API pieņem vērtības no 0 līdz 2, taču jebkura vērtība virs 1 tiek automātiski samazināta līdz 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
xAI labākās prakses vadlīnijas ir skaidras: iestati temperature uz 0,7 un nenovirzies no šīs vērtības, jo Grok modeļi reaģē slikti uz citiem izlases iestatījumiem. Ja vēlies mainīt toni uz faktoloģiskāku vai radošāku, pielāgo promptu, nevis temperatūru.
top_p
Kodola izlase (nucleus sampling). Pašreizējiem teksta modeļiem noklusējuma vērtība ir 0,95, un jebkura vērtība, kas pārsniedz modeļa noklusējumu, tiek samazināta līdz tam.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Iestatot top_p: 0.95, modelis ņem vērā tikai tos tokenus, kas veido 95 % no varbūtības sadalījuma. Lai gan API atsauces dokumentācija atkārto klasisko padomu mainīt tikai vienu no abiem parametriem, xAI labākā prakse prasa katrā pieprasījumā eksplicīti iestatīt abus: temperature uz 0,7 un top_p uz 0,95.
max_output_tokens
Ierobežo tokenus skaitu redzamajā atbildē; spriešanas procesi un funkciju izsaukumi netiek ieskaitīti, un noklusējuma vērtība ir 128 000 tokeni:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Spriešanas modeļiem iekšējo refleksiju regulē nevis šis limits, bet gan spriešanas intensitāte (reasoning effort). Ja atbilde tiek pārtraukta šī limita dēļ, tas tiek signalizēts ar statusu incomplete.
reasoning (spriešana)
Modeļiem, kas atbalsta spriešanu, tu vari pielāgot intensitāti:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Iespējamās vērtības ir low, medium un high (noklusējums), kā arī xhigh modeļiem grok-4.6 un grok-4.7. Šis parametrs attiecas uz modeļiem no grok-4.5 līdz 4.7, bet grok-4.20-0309-reasoning to nepieņem. Augsta intensitāte patērē vairāk tokenus un ir piemērota sarežģītām problēmām.
Sarunu parametri
store (glabāšana)
Nosaka, vai atbilde tiek glabāta servera pusē:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: atbilde tiek glabāta 30 dienas, to var izgūt, izmantojot GET pieprasījumu, un izmantot kopā arprevious_response_id.false: atbilde netiek saglabāta (privātais režīms).
previous_response_id
Sasaista jaunu pieprasījumu ar esošu sarunu (detalizēti aplūkots 5. nodarbībā).
user (lietotājs)
Beigu lietotāja identifikators, kas noder izsekošanai un moderācijai:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Rīku parametri
tools, tool_choice, parallel_tool_calls, max_turns
Šie parametri kontrolē rīku (web_search, code_interpreter, pielāgotas funkcijas) izmantošanu. Tie detalizēti aplūkoti sadaļā „Rīki” (9.–12. nodarbība).
Parametru kopsavilkums
| Parametrs | Tips | Noklusējums | Lietojums |
|---|---|---|---|
model | virkne | nepieciešams | Modeļa identifikators |
input | virkne/masīvs | nepieciešams | Lietotāja prompts |
instructions | virkne | null | Sistēmas prompts |
temperature | skaitlis | — | Ieteicams 0,7; maksimāli 1 |
top_p | skaitlis | 0.95 | Kodola izlase |
max_output_tokens | vesels skaitlis | 128 000 | Redzamās atbildes limits |
reasoning | objekts | null | Spriešanas intensitāte |
store | loģisks | null | 30 dienu saglabāšana |
stream | loģisks | false | SSE straumēšana |
user | virkne | null | Beigu lietotāja ID |
Galvenās atziņas
- xAI iesaka eksplicīti iestatīt
temperatureuz 0,7 untop_puz 0,95. max_output_tokensierobežo tikai redzamo atbildi, neieskaitot spriešanas procesu.store: truesaglabā atbildi uz 30 dienām, lai nodrošinātu sarunu ķēdes veidošanu.reasoning.effortļauj mērogot modeļa refleksiju atkarībā no uzdevuma sarežģītības.- Parametrs
userpalīdz xAI pusē veikt izsekošanu un moderāciju.