Salt la conținutul principal
Română— Alege o limbă
Meniu

Parametri de cerere

Lecția 3 din 16 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Controlul comportamentului modelului
  2. Parametri de generare
  3. Parametri de conversație
  4. Parametri de instrumente
  5. Rezumatul parametrilor
  6. Puncte cheie

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_p 0,95 implicit; max_output_tokens limitat 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 cu previous_response_id
  • false: 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

ParametruTipImplicitUtilizare
modelstringobligatoriuIdentificator model
inputstring/arrayobligatoriuPrompt utilizator
instructionsstringnullPrompt sistem
temperaturenumber—0,7 recomandat; limitat la 1
top_pnumber0,95Eșantionare nucleu
max_output_tokensinteger128.000Limită răspuns vizibil
reasoningobjectnullEfort de raționament
storebooleannullPersistență 30 de zile
streambooleanfalseStreaming SSE
userstringnullID utilizator final

Puncte cheie

  • xAI recomandă temperature la 0,7 și top_p la 0,95, setate explicit
  • max_output_tokens limitează doar răspunsul vizibil, excluzând raționamentul
  • store: true persistă răspunsul timp de 30 de zile pentru înlănțuirea conversațiilor
  • reasoning.effort vă permite să scalați reflecția modelului în funcție de complexitatea sarcinii
  • Parametrul user ajută la urmărire și moderare din partea xAI