Kérési paraméterek
Ezen az oldalon
Frissítve: 2026. november 3. A Responses API referenciája és az xAI legjobb gyakorlatai alapján: ajánlott hőmérséklet 0,7 (maximálisan 1-re korlátozva);
top_palapértelmezetten 0,95;max_output_tokenscsak a látható válaszra korlátozódik (alapértelmezett 128 000, a következtetés nélkül); a következtetési erőfeszítés csak a grok-4.5-től 4.7-ig elérhető. Források: Responses API · Legjobb gyakorlatok.
A modell viselkedésének vezérlése
A model, input és instructions paramétereken túl a Responses API számos további beállítást kínál a Grok viselkedésének finomhangolására. Ezen paraméterek megértésével igényeidnek megfelelően relevánsabb, rövidebb vagy kreatívabb válaszokat érhetsz el.
Generálási paraméterek
temperature (hőmérséklet)
Szabályozza a válaszok véletlenszerűségét. Az API a 0 és 2 közötti értékeket fogadja el, de az 1 feletti bármilyen értéket 1-re mintavételez.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Az xAI legjobb gyakorlatai egyértelműek: állítsd a temperature értékét 0,7-re, és ne térj el jelentősen ettől, mert a Grok modellek rosszul reagálnak más mintavételezési beállításokra. Ha tényközlőbb vagy kreatívabb hangnemet szeretnél, inkább a promptot módosítsd, ne a hőmérsékletet.
top_p
Magmintavételezés (nucleus sampling). A jelenlegi szöveges modellek alapértelmezett értéke 0,95, és a modell alapértelmezett értékénél magasabb bármilyen értéket erre csökkentenek.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
A top_p: 0.95 beállítással a modell csak azokat a tokeneket veszi figyelembe, amelyek a valószínűség 95%-át teszik ki. Az API referencia a klasszikus tanácsot ismétli, miszerint e két paraméter közül csak az egyiket érdemes módosítani; az xAI legjobb gyakorlatai azonban előírják, hogy minden kérésnél mindkettőt állítsd be explicit módon: 0,7-re, illetve 0,95-re.
max_output_tokens
Korlátozza a látható válasz tokenjeinek számát; a következtetés és a függvényhívások nem számítanak bele, az alapértelmezett érték pedig 128 000 token:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
A következtető modelleknél nem ez a korlát, hanem a következtetési erőfeszítés (reasoning effort) szabályozza a belső gondolkodást. Ha a válasz levágásra kerül e korlát miatt, azt az rendszer egy incomplete állapottal jelzi.
reasoning (következtetés)
Azoknál a modelleknél, amelyek támogatják a következtetést, beállíthatod az erőfeszítés mértékét:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
A lehetséges értékek: low, medium és high (alapértelmezett), valamint xhigh a grok-4.6 és grok-4.7 modelleken; a paraméter a grok-4.5-től 4.7-ig érvényes, a grok-4.20-0309-reasoning viszont nem fogadja el. A magas erőfeszítés több tokent fogyaszt, és összetett feladatokhoz illik.
Beszélgetési paraméterek
store (tárolás)
Meghatározza, hogy a választ tárolja-e a szerver oldalon:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: a választ 30 napig tárolja, GET kéréssel lekérhető, és használható aprevious_response_idparaméterrelfalse: a válasz nem kerül megőrzésre (privát mód)
previous_response_id
Összeláncol egy új kérést egy meglévő beszélgetéssel (részletesen az 5. leckében tárgyaljuk).
user
A végfelhasználó azonosítója, amely nyomkövetéshez és moderációhoz hasznos:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Eszközparaméterek
tools, tool_choice, parallel_tool_calls, max_turns
Ezek a paraméterek az eszközhasználatot (webes keresés, kódértelmező, egyéni függvények) vezérlik. Részletes kifejtésük az „Eszközök“ szekcióban (9–12. leckék) található.
Paraméterek összefoglalása
| Paraméter | Típus | Alapértelmezett | Használat |
|---|---|---|---|
model | string | kötelező | Modellazonosító |
input | string/array | kötelező | Felhasználói prompt |
instructions | string | null | Rendszerprompt |
temperature | number | — | Ajánlott: 0,7; 1-re korlátozva |
top_p | number | 0.95 | Magmintavételezés |
max_output_tokens | integer | 128,000 | Látható válasz korlátja |
reasoning | object | null | Következtetési erőfeszítés |
store | boolean | null | 30 napos megőrzés |
stream | boolean | false | SSE streamelés |
user | string | null | Végfelhasználó azonosítója |
Főbb megállapítások
- Az xAI ajánlása szerint a
temperatureértéke 0,7, atop_pértéke pedig 0,95 legyen, mindkettőt állítsd be explicit módon - A
max_output_tokenscsak a látható választ korlátozza, a következtetést nem tartalmazza - A
store: truebeállítás 30 napig megőrzi a választ a beszélgetések összeláncolásához - A
reasoning.effortparaméterrel a feladat összetettsége alapján skálázhatod a modell gondolkodási mélységét - A
userparaméter segít az xAI oldalán történő nyomkövetésben és moderációban