Parametri di richiesta
In questa pagina
Aggiornato il 3 novembre 2026. Basato sul riferimento delle API Responses e sulle best practice di xAI: temperatura consigliata 0.7, con limite massimo a 1;
top_pimpostato di default a 0.95;max_output_tokenslimitato alla risposta visibile (128.000 di default, ragionamento escluso); lo sforzo di ragionamento è riservato ai modelli da grok-4.5 a 4.7. Fonti: API Responses · Best practices.
Controllo del comportamento del modello
Oltre a model, input e instructions, le API Responses offrono numerosi parametri per affinare il comportamento di Grok. Comprendere questi parametri ti permette di ottenere risposte più pertinenti, più brevi o più creative in base alle tue esigenze.
Parametri di generazione
temperature
Controlla la casualità delle risposte. L’API accetta valori da 0 a 2, ma qualsiasi valore superiore a 1 viene campionato come se fosse 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Le best practice di xAI sono chiare: imposta temperature a 0.7 e non discostartene troppo, perché i modelli Grok reagiscono male ad altre impostazioni di campionamento. Per ottenere un tono più fattuale o creativo, modifica il prompt piuttosto che la temperatura.
top_p
Campionamento del nucleo (nucleus sampling). I modelli testuali attuali hanno un default di 0.95 e qualsiasi valore superiore al default del modello viene ridotto a questo.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Con top_p: 0.95, il modello considera solo i token che rappresentano il 95% della probabilità. Il riferimento API ripete il classico consiglio di regolare solo uno dei due parametri; le best practice di xAI richiedono invece di impostare esplicitamente entrambi, a 0.7 e 0.95, in ogni richiesta.
max_output_tokens
Limita il numero di token nella risposta visibile; il ragionamento e le chiamate di funzione non vengono conteggiati e il valore predefinito è 128.000 token:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Per i modelli di ragionamento, è lo sforzo di ragionamento (reasoning effort), e non questo limite, a governare la riflessione interna. Una risposta interrotta dal limite viene segnalata dallo stato incomplete.
reasoning
Per i modelli che supportano il ragionamento, puoi regolare lo sforzo:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
I valori possibili sono low, medium e high (default), più xhigh su grok-4.6 e grok-4.7; il parametro si applica da grok-4.5 a 4.7, mentre grok-4.20-0309-reasoning non lo accetta. Uno sforzo elevato consuma più token ed è adatto a problemi complessi.
Parametri di conversazione
store
Determina se la risposta viene memorizzata lato server:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: la risposta viene archiviata per 30 giorni, recuperabile tramite GET e utilizzabile conprevious_response_idfalse: la risposta non viene persistita (modalità privata)
previous_response_id
Collega una nuova richiesta a una conversazione esistente (dettagliato nella lezione 5).
user
Identificatore dell’utente finale, utile per il tracciamento e la moderazione:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametri degli strumenti
tools, tool_choice, parallel_tool_calls, max_turns
Questi parametri controllano l’uso degli strumenti (web_search, code_interpreter, funzioni personalizzate). Sono trattati in dettaglio nella sezione “Strumenti” (lezioni 9-12).
Riepilogo dei parametri
| Parametro | Tipo | Default | Utilizzo |
|---|---|---|---|
model | string | richiesto | Identificatore del modello |
input | string/array | richiesto | Prompt dell’utente |
instructions | string | null | Prompt di sistema |
temperature | number | — | 0.7 consigliato; limite a 1 |
top_p | number | 0.95 | Campionamento del nucleo |
max_output_tokens | integer | 128.000 | Limite risposta visibile |
reasoning | object | null | Sforzo di ragionamento |
store | boolean | null | Persistenza di 30 giorni |
stream | boolean | false | Streaming SSE |
user | string | null | ID utente finale |
Punti chiave
- xAI consiglia
temperaturea 0.7 etop_pa 0.95, da impostare esplicitamente max_output_tokenslimita solo la risposta visibile, escludendo il ragionamentostore: truepersiste la risposta per 30 giorni per il concatenamento delle conversazionireasoning.effortti permette di scalare la riflessione del modello in base alla complessità del compito- Il parametro
useraiuta nel tracciamento e nella moderazione da parte di xAI