Parâmetros do Pedido
Nesta página
Atualizado em 3 de novembro de 2026. Com base na referência da API de Respostas e nas melhores práticas da xAI: temperatura recomendada de 0,7, limitada a 1;
top_p0,95 por predefinição;max_output_tokenslimitado à resposta visível (128.000 por predefinição, raciocínio excluído); esforço de raciocínio reservado ao grok-4.5 até 4.7. Fontes: API de Respostas · Melhores práticas.
Controlar o comportamento do modelo
Para além de model, input e instructions, a API de Respostas oferece numerosos parâmetros para afinar o comportamento do Grok. Compreender estes parâmetros permite obter respostas mais relevantes, mais curtas ou mais criativas, consoante as suas necessidades.
Parâmetros de geração
temperature
Controla a aleatoriedade das respostas. A API aceita valores de 0 a 2, mas qualquer valor acima de 1 é amostrado como 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
As melhores práticas da xAI são claras: defina temperature como 0,7 e não se afaste muito desse valor, pois os modelos Grok reagem mal a outras configurações de amostragem. Para um tom mais factual ou criativo, ajuste o prompt em vez da temperatura.
top_p
Amostragem de núcleo (nucleus sampling). Os modelos de texto atuais têm 0,95 como predefinição, e qualquer valor superior ao padrão do modelo é reduzido a esse limite.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Com top_p: 0.95, o modelo considera apenas os tokens que representam 95% da probabilidade. A referência da API repete o conselho clássico de ajustar apenas um dos dois parâmetros; no entanto, as melhores práticas da xAI exigem a definição explícita de ambos, para 0,7 e 0,95, em cada pedido.
max_output_tokens
Limita o número de tokens na resposta visível; o raciocínio e as chamadas de função não contam, e o valor predefinido é de 128.000 tokens:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Para modelos de raciocínio, é o esforço de raciocínio, e não este limite, que governa a reflexão interna. Uma resposta cortada pelo limite é sinalizada com o estado incomplete.
reasoning
Para modelos que suportam raciocínio, pode ajustar o esforço:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Os valores possíveis são low, medium e high (predefinição), além de xhigh no grok-4.6 e grok-4.7; o parâmetro aplica-se ao grok-4.5 até 4.7, e o grok-4.20-0309-reasoning não o aceita. Um esforço elevado consome mais tokens e é adequado para problemas complexos.
Parâmetros de conversação
store
Determina se a resposta é armazenada no lado do servidor:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: resposta armazenada por 30 dias, recuperável via GET, utilizável comprevious_response_idfalse: resposta não persistida (modo privado)
previous_response_id
Encadeia um novo pedido a uma conversação existente (detalhado na lição 5).
user
Identificador do utilizador final, útil para rastreio e moderação:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parâmetros de ferramentas
tools, tool_choice, parallel_tool_calls, max_turns
Estes parâmetros controlam a utilização de ferramentas (web_search, code_interpreter, funções personalizadas). São abordados em detalhe na secção «Ferramentas» (lições 9 a 12).
Resumo dos parâmetros
| Parâmetro | Tipo | Predefinição | Utilização |
|---|---|---|---|
model | string | obrigatório | Identificador do modelo |
input | string/array | obrigatório | Prompt do utilizador |
instructions | string | null | Prompt do sistema |
temperature | number | — | 0,7 recomendado; limitado a 1 |
top_p | number | 0,95 | Amostragem de núcleo |
max_output_tokens | integer | 128.000 | Limite da resposta visível |
reasoning | object | null | Esforço de raciocínio |
store | boolean | null | Persistência de 30 dias |
stream | boolean | false | Streaming SSE |
user | string | null | ID do utilizador final |
Pontos-chave
- A xAI recomenda
temperatureem 0,7 etop_pem 0,95, definidos explicitamente max_output_tokenslimita apenas a resposta visível, excluindo o raciocíniostore: truepersiste a resposta por 30 dias para encadeamento de conversaçãoreasoning.effortpermite escalar a reflexão do modelo com base na complexidade da tarefa- O parâmetro
userajuda no rastreio e na moderação do lado da xAI