Parametry požadavku
Na této stránce
Aktualizováno 3. listopadu 2026. Na základě reference API Responses a osvědčených postupů xAI: doporučená teplota 0,7, omezená na 1;
top_pve výchozím nastavení 0,95;max_output_tokensomezeno na viditelnou odpověď (výchozí hodnota 128 000, uvažování se nepočítá); úsilí při uvažování vyhrazeno pro modely grok-4.5 až 4.7. Zdroje: API Responses · Osvědčené postupy.
Řízení chování modelu
Kromě parametrů model, input a instructions nabízí API Responses řadu dalších parametrů pro jemné doladění chování modelu Grok. Pochopení těchto parametrů ti umožní získat relevantnější, kratší nebo kreativnější odpovědi podle tvých potřeb.
Parametry generování
temperature
Řídí náhodnost odpovědí. API přijímá hodnoty od 0 do 2, ale jakákoli hodnota nad 1 je vzorkována jako 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Osvědčené postupy xAI jsou jasné: nastav temperature na 0,7 a příliš se od této hodnoty nevzdaluj, protože modely Grok reagují špatně na jiná nastavení vzorkování. Pro více faktický nebo kreativní tón uprav raději prompt než teplotu.
top_p
Jaderné vzorkování (nucleus sampling). Aktuální textové modely mají výchozí hodnotu 0,95 a jakákoli vyšší hodnota je na tuto hodnotu snížena.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Při nastavení top_p: 0.95 model zvažuje pouze tokeny, které tvoří 95 % pravděpodobnosti. Reference API opakuje klasickou radu upravovat pouze jeden ze dvou parametrů; osvědčené postupy xAI však vyžadují explicitní nastavení obou parametrů na každém požadavku, a to na hodnoty 0,7 a 0,95.
max_output_tokens
Omezuje počet tokenů ve viditelné odpovědi; uvažování a volání funkcí se do tohoto limitu nepočítají. Výchozí hodnota je 128 000 tokenů:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
U modelů s uvažováním řídí vnitřní reflexi parametr úsilí při uvažování (reasoning effort), nikoli tento limit. Pokud je odpověď přerušena kvůli dosažení limitu, je signalizována stavem incomplete.
reasoning
U modelů, které podporují uvažování, můžeš upravit míru úsilí:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Možné hodnoty jsou low, medium a high (výchozí), plus xhigh pro modely grok-4.6 a grok-4.7. Tento parametr platí pro modely grok-4.5 až 4.7; model grok-4.20-0309-reasoning jej nepřijímá. Vysoké úsilí spotřebuje více tokenů a hodí se pro složité úlohy.
Parametry konverzace
store
Určuje, zda je odpověď uložena na straně serveru:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: odpověď je uložena na 30 dní, lze ji získat pomocí GET a použít s parametremprevious_response_idfalse: odpověď není trvale uložena (režim soukromí)
previous_response_id
Propojuje nový požadavek s existující konverzací (podrobněji v lekci 5).
user
Identifikátor koncového uživatele, užitečný pro sledování a moderaci:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametry nástrojů
tools, tool_choice, parallel_tool_calls, max_turns
Tyto parametry řídí používání nástrojů (web_search, code_interpreter, vlastní funkce). Podrobně jsou probírány v sekci „Nástroje“ (lekce 9–12).
Shrnutí parametrů
| Parametr | Typ | Výchozí hodnota | Použití |
|---|---|---|---|
model | řetězec | povinný | Identifikátor modelu |
input | řetězec/pole | povinný | Prompt uživatele |
instructions | řetězec | null | Systémový prompt |
temperature | číslo | — | Doporučeno 0,7; omezeno na 1 |
top_p | číslo | 0,95 | Jaderné vzorkování |
max_output_tokens | celé číslo | 128 000 | Limit viditelné odpovědi |
reasoning | objekt | null | Úsilí při uvažování |
store | boolean | null | Perzistence po dobu 30 dnů |
stream | boolean | false | Streamování přes SSE |
user | řetězec | null | ID koncového uživatele |
Klíčové poznatky
- xAI doporučuje nastavit
temperaturena 0,7 atop_pna 0,95, a to explicitně max_output_tokensomezuje pouze viditelnou odpověď, bez zahrnutí uvažovánístore: trueuchovává odpověď po dobu 30 dnů pro řetězení konverzacíreasoning.effortti umožňuje škálovat hloubku uvažování modelu podle složitosti úlohy- Parametr
userpomáhá na straně xAI se sledováním a moderací