Parametre požiadavky
Na tejto strane
Aktualizované 3. novembra 2026. Na základe referencie Responses API a osvedčených postupov xAI: odporúčaná teplota 0,7, obmedzená na 1;
top_ppredvolene 0,95;max_output_tokensobmedzené na viditeľnú odpoveď (predvolene 128 000, bez uvažovania); úsilie pri uvažovaní vyhradené pre modely grok-4.5 až 4.7. Zdroje: Responses API · Osvedčené postupy.
Ovládanie správania modelu
Okrem parametrov model, input a instructions ponúka Responses API množstvo ďalších parametrov na jemné doladenie správania Groka. Pochopenie týchto parametrov ti umožní získať relevantnejšie, kratšie alebo kreatívnejšie odpovede podľa tvojich potrieb.
Parametre generovania
temperature
Ovláda náhodnosť odpovedí. API akceptuje hodnoty od 0 do 2, ale akákoľvek hodnota nad 1 sa vzorkuje ako 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Osvedčené postupy xAI sú jasné: nastav temperature na 0,7 a príliš sa od tejto hodnoty nevzďaľuj, pretože modely Grok reagujú zle na iné nastavenia vzorkovania. Pre faktickejší alebo kreatívnejší tón uprav radšej prompt než teplotu.
top_p
Jadrové vzorkovanie (nucleus sampling). Aktuálne textové modely majú predvolenú hodnotu 0,95 a akákoľvek vyššia hodnota sa zníži na túto predvolenú hodnotu modelu.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Pri hodnote top_p: 0.95 model berie do úvahy iba tokeny, ktoré predstavujú 95 % pravdepodobnosti. Referencia API opakuje klasickú radu upravovať iba jeden z týchto dvoch parametrov; osvedčené postupy xAI však vyžadujú explicitné nastavenie oboch parametrov na každej požiadavke, a to na hodnoty 0,7 a 0,95.
max_output_tokens
Obmedzuje počet tokenov vo viditeľnej odpovedi; uvažovanie a volania funkcií sa nepočítajú a predvolená hodnota je 128 000 tokenov:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Pri modeloch s uvažovaním riadi internú reflexiu parameter úsilia pri uvažovaní (reasoning effort), nie tento limit. Odpoveď prerušená týmto limitom je signalizovaná stavom incomplete.
reasoning
Pre modely, ktoré podporujú uvažovanie, môžeš upraviť úsilie:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Možné hodnoty sú low, medium a high (predvolené), plus xhigh pre modely grok-4.6 a grok-4.7; parameter platí pre modely grok-4.5 až 4.7 a model grok-4.20-0309-reasoning ho neprijíma. Vysoké úsilie spotrebuje viac tokenov a hodí sa pre zložité problémy.
Parametre konverzácie
store
Určuje, či sa odpoveď uloží na strane servera:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: odpoveď sa uloží na 30 dní, je získateľná prostredníctvom GET a použiteľná s parametromprevious_response_idfalse: odpoveď sa neuloží (súkromný režim)
previous_response_id
Prepojí novú požiadavku s existujúcou konverzáciou (podrobne popísané v lekcii 5).
user
Identifikátor koncového používateľa, užitočný na sledovanie a moderovanie:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametre nástrojov
tools, tool_choice, parallel_tool_calls, max_turns
Tieto parametre riadia používanie nástrojov (web_search, code_interpreter, vlastné funkcie). Podrobne sú pokryté v sekcii „Nástroje“ (lekcie 9 – 12).
Zhrnutie parametrov
| Parameter | Typ | Predvolená hodnota | Použitie |
|---|---|---|---|
model | string | povinné | Identifikátor modelu |
input | string/array | povinné | Prompt používateľa |
instructions | string | null | Systémový prompt |
temperature | number | — | Odporúčané 0,7; obmedzené na 1 |
top_p | number | 0.95 | Jadrové vzorkovanie |
max_output_tokens | integer | 128 000 | Limit viditeľnej odpovede |
reasoning | object | null | Úsilie pri uvažovaní |
store | boolean | null | Perzistencia na 30 dní |
stream | boolean | false | Streamovanie cez SSE |
user | string | null | ID koncového používateľa |
Kľúčové poznatky
- xAI odporúča nastaviť
temperaturena 0,7 atop_pna 0,95 explicitne max_output_tokensobmedzuje iba viditeľnú odpoveď, bez zahrnutia uvažovaniastore: trueuchováva odpoveď na 30 dní pre prepojenie konverzáciíreasoning.effortti umožňuje škálovať reflexiu modelu podľa zložitosti úlohy- Parameter
userpomáha so sledovaním a moderovaním na strane xAI