Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Parametry požadavku

Lekce 3 z 16 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Řízení chování modelu
  2. Parametry generování
  3. Parametry konverzace
  4. Parametry nástrojů
  5. Shrnutí parametrů
  6. Klíčové poznatky

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_p ve výchozím nastavení 0,95; max_output_tokens omezeno 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 parametrem previous_response_id
  • false: 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ů

ParametrTypVýchozí hodnotaPoužití
modelřetězecpovinnýIdentifikátor modelu
inputřetězec/polepovinnýPrompt uživatele
instructionsřetězecnullSystémový prompt
temperaturečíslo—Doporučeno 0,7; omezeno na 1
top_pčíslo0,95Jaderné vzorkování
max_output_tokenscelé číslo128 000Limit viditelné odpovědi
reasoningobjektnullÚsilí při uvažování
storebooleannullPerzistence po dobu 30 dnů
streambooleanfalseStreamování přes SSE
userřetězecnullID koncového uživatele

Klíčové poznatky

  • xAI doporučuje nastavit temperature na 0,7 a top_p na 0,95, a to explicitně
  • max_output_tokens omezuje pouze viditelnou odpověď, bez zahrnutí uvažování
  • store: true uchovává odpověď po dobu 30 dnů pro řetězení konverzací
  • reasoning.effort ti umožňuje škálovat hloubku uvažování modelu podle složitosti úlohy
  • Parametr user pomáhá na straně xAI se sledováním a moderací