Parametri zahtjeva
Na ovoj stranici
Ažurirano 3. studenoga 2026. Na temelju referencije Responses API-ja i najboljih praksi tvrtke xAI: preporučena temperatura 0.7, ograničena na 1;
top_pzadano 0.95;max_output_tokensograničen na vidljivi odgovor (zadano 128.000, zaključivanje isključeno); napor zaključivanja rezerviran za modele grok-4.5 do 4.7. Izvori: Responses API · Najbolje prakse.
Kontrola ponašanja modela
Osim parametara model, input i instructions, Responses API nudi brojne parametre za fino podešavanje ponašanja Groka. Razumijevanje ovih parametara omogućuje ti dobivanje relevantnijih, kraćih ili kreativnijih odgovora ovisno o tvojim potrebama.
Parametri generiranja
temperature
Kontrolira slučajnost odgovora. API prihvaća vrijednosti od 0 do 2, no sve iznad 1 uzorkuje se kao 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Najbolje prakse tvrtke xAI jasne su: postavi temperature na 0.7 i ne odstupaj puno od te vrijednosti jer Grok modeli loše reagiraju na druge postavke uzorkovanja. Za faktičniji ili kreativniji ton prilagodi upit (prompt), a ne temperaturu.
top_p
Uzorkovanje jezgre (nucleus sampling). Trenutni tekstualni modeli imaju zadanu vrijednost 0.95, a svaka vrijednost viša od zadane smanjuje se na tu razinu.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
S postavkom top_p: 0.95, model razmatra samo tokene koji čine 95 % vjerojatnosti. Referencija API-ja ponavlja klasični savjet da se prilagodi samo jedan od ta dva parametra, no najbolje prakse tvrtke xAI zahtijevaju eksplicitno postavljanje oba parametra na svakom zahtjevu: 0.7 i 0.95.
max_output_tokens
Ograničava broj tokena u vidljivom odgovoru; zaključivanje i pozivi funkcija se ne računaju, a zadana vrijednost iznosi 128.000 tokena:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Kod modela za zaključivanje, napor zaključivanja (reasoning effort), a ne ovo ograničenje, upravlja internom refleksijom. Odgovor prekinut zbog ovog ograničenja signalizira se statusom incomplete.
reasoning
Za modele koji podržavaju zaključivanje, možeš prilagoditi napor:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Moguće vrijednosti su low, medium i high (zadano), plus xhigh za grok-4.6 i grok-4.7; parametar se primjenjuje na grok-4.5 do 4.7, dok grok-4.20-0309-reasoning ne prihvaća ovaj parametar. Visok napor troši više tokena i prikladan je za složene probleme.
Parametri razgovora
store
Određuje sprema li se odgovor na poslužitelju:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: odgovor se sprema 30 dana, dohvatljiv putem GET zahtjeva, upotrebljiv sprevious_response_idfalse: odgovor se ne trajno pohranjuje (privatni način rada)
previous_response_id
Povezuje novi zahtjev s postojećim razgovorom (detaljno obrađeno u lekciji 5).
user
Identifikator krajnjeg korisnika, koristan za praćenje i moderiranje:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametri alata
tools, tool_choice, parallel_tool_calls, max_turns
Ovi parametri kontroliraju upotrebu alata (web_search, code_interpreter, prilagođene funkcije). Detaljno su obrađeni u odjeljku „Alati“ (lekcije 9–12).
Sažetak parametara
| Parametar | Tip | Zadano | Upotreba |
|---|---|---|---|
model | string | obavezno | Identifikator modela |
input | string/array | obavezno | Korisnički upit |
instructions | string | null | Sistemski upit |
temperature | number | — | Preporučeno 0.7; ograničeno na 1 |
top_p | number | 0.95 | Uzorkovanje jezgre |
max_output_tokens | integer | 128.000 | Ograničenje vidljivog odgovora |
reasoning | object | null | Napor zaključivanja |
store | boolean | null | Trajnost od 30 dana |
stream | boolean | false | SSE strujanje |
user | string | null | ID krajnjeg korisnika |
Ključne točke
- xAI preporučuje
temperaturena 0.7 itop_pna 0.95, uz eksplicitno postavljanje max_output_tokensograničava samo vidljivi odgovor, isključujući zaključivanjestore: truetrajno pohranjuje odgovor na 30 dana radi lančanja razgovorareasoning.effortomogućuje skaliranje refleksije modela ovisno o složenosti zadatka- Parametar
userpomaže u praćenju i moderiranju na strani tvrtke xAI