Parametri de cerere
Pe această pagină
Actualizat la 3 noiembrie 2026. Pe baza referinței API Responses și a celor mai bune practici xAI: temperatură recomandată 0,7, limitată la 1;
top_p0,95 implicit;max_output_tokenslimitat la răspunsul vizibil (128.000 implicit, raționamentul exclus); efortul de raționament rezervat pentru grok-4.5 până la 4.7. Surse: API Responses · Cele mai bune practici.
Controlul comportamentului modelului
Dincolo de model, input și instructions, API-ul Responses oferă numeroși parametri pentru a regla fin comportamentul lui Grok. Înțelegerea acestor parametri vă permite să obțineți răspunsuri mai relevante, mai scurte sau mai creative, în funcție de nevoile dumneavoastră.
Parametri de generare
temperature
Controlează aleatorietatea răspunsurilor. API-ul acceptă valori de la 0 la 2, dar orice valoare peste 1 este eșantionată ca fiind 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Cele mai bune practici xAI sunt clare: setați temperature la 0,7 și nu vă abateți mult de la această valoare, deoarece modelele Grok reacționează slab la alte setări de eșantionare. Pentru un ton mai factual sau mai creativ, ajustați promptul, nu temperatura.
top_p
Eșantionare nucleu (nucleus sampling). Modelele text actuale au implicit 0,95, iar orice valoare mai mare decât implicitul modelului este redusă la acesta.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Cu top_p: 0.95, modelul ia în considerare doar token-urile care reprezintă 95% din probabilitate. Referința API repetă sfatul clasic de a ajusta doar unul dintre cei doi parametri; însă cele mai bune practici xAI cer setarea explicită a ambelor, la 0,7 și respectiv 0,95, la fiecare cerere.
max_output_tokens
Limitează numărul de token-uri din răspunsul vizibil; raționamentul și apelurile de funcții nu se contorizează, iar valoarea implicită este de 128.000 de token-uri:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Pentru modelele de raționament, efortul de raționament, nu această limită, guvernează reflecția internă. Un răspuns întrerupt de această limită este semnalat printr-un status incomplete.
reasoning
Pentru modelele care suportă raționamentul, puteți ajusta efortul:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Valorile posibile sunt low, medium și high (implicit), plus xhigh pe grok-4.6 și grok-4.7; parametrul se aplică pentru grok-4.5 până la 4.7, iar grok-4.20-0309-reasoning nu îl acceptă. Efortul ridicat consumă mai multe token-uri și este potrivit pentru probleme complexe.
Parametri de conversație
store
Determină dacă răspunsul este stocat pe server:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: răspunsul este stocat timp de 30 de zile, recuperabil prin GET, utilizabil cuprevious_response_idfalse: răspunsul nu este persistat (mod privat)
previous_response_id
Înlănțuie o nouă cerere la o conversație existentă (detaliat în lecția 5).
user
Identificator al utilizatorului final, util pentru urmărire și moderare:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametri de instrumente
tools, tool_choice, parallel_tool_calls, max_turns
Acești parametri controlează utilizarea instrumentelor (web_search, code_interpreter, funcții personalizate). Ei sunt acoperiți în detaliu în secțiunea „Instrumente“ (lecțiile 9-12).
Rezumatul parametrilor
| Parametru | Tip | Implicit | Utilizare |
|---|---|---|---|
model | string | obligatoriu | Identificator model |
input | string/array | obligatoriu | Prompt utilizator |
instructions | string | null | Prompt sistem |
temperature | number | — | 0,7 recomandat; limitat la 1 |
top_p | number | 0,95 | Eșantionare nucleu |
max_output_tokens | integer | 128.000 | Limită răspuns vizibil |
reasoning | object | null | Efort de raționament |
store | boolean | null | Persistență 30 de zile |
stream | boolean | false | Streaming SSE |
user | string | null | ID utilizator final |
Puncte cheie
- xAI recomandă
temperaturela 0,7 șitop_pla 0,95, setate explicit max_output_tokenslimitează doar răspunsul vizibil, excluzând raționamentulstore: truepersistă răspunsul timp de 30 de zile pentru înlănțuirea conversațiilorreasoning.effortvă permite să scalați reflecția modelului în funcție de complexitatea sarcinii- Parametrul
userajută la urmărire și moderare din partea xAI