Parámetros de solicitud
En esta página
Actualizado el 3 de noviembre de 2026. Basado en la referencia de la API de Responses y las mejores prácticas de xAI: temperatura recomendada de 0,7, limitada a 1;
top_p0,95 por defecto;max_output_tokenslimitado a la respuesta visible (128.000 por defecto, razonamiento excluido); el esfuerzo de razonamiento está reservado para grok-4.5 a 4.7. Fuentes: API de Responses · Mejores prácticas.
Control del comportamiento del modelo
Más allá de model, input e instructions, la API de Responses ofrece numerosos parámetros para ajustar finamente el comportamiento de Grok. Comprender estos parámetros te permite obtener respuestas más relevantes, más breves o más creativas según tus necesidades.
Parámetros de generación
temperature
Controla la aleatoriedad de las respuestas. La API acepta valores de 0 a 2, pero cualquier valor superior a 1 se muestrea como 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Las mejores prácticas de xAI son claras: establece temperature en 0,7 y no te desvíes apenas de este valor, porque los modelos Grok reaccionan mal a otras configuraciones de muestreo. Para lograr un tono más factual o creativo, ajusta el prompt en lugar de la temperatura.
top_p
Muestreo de núcleo (nucleus sampling). Los modelos de texto actuales tienen 0,95 como valor por defecto, y cualquier valor superior al predeterminado del modelo se reduce a este.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Con top_p: 0.95, el modelo considera únicamente los tokens que representan el 95 % de la probabilidad. La referencia de la API repite el consejo clásico de ajustar solo uno de los dos parámetros; sin embargo, las mejores prácticas de xAI exigen establecer explícitamente ambos, a 0,7 y 0,95, en cada solicitud.
max_output_tokens
Limita el número de tokens en la respuesta visible; el razonamiento y las llamadas a funciones no cuentan, y el valor por defecto es de 128.000 tokens:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Para los modelos de razonamiento, el esfuerzo de razonamiento, no este límite, gobierna la reflexión interna. Una respuesta cortada por el límite se señala con un estado incomplete.
reasoning
Para los modelos que admiten razonamiento, puedes ajustar el esfuerzo:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Los valores posibles son low, medium y high (por defecto), además de xhigh en grok-4.6 y grok-4.7; el parámetro se aplica a grok-4.5 hasta 4.7, y grok-4.20-0309-reasoning no lo acepta. Un esfuerzo alto consume más tokens y es adecuado para problemas complejos.
Parámetros de conversación
store
Determina si la respuesta se almacena en el servidor:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: la respuesta se almacena durante 30 días, recuperable mediante GET, utilizable conprevious_response_idfalse: la respuesta no se persiste (modo privado)
previous_response_id
Encadena una nueva solicitud a una conversación existente (se detalla en la lección 5).
user
Identificador del usuario final, útil para el seguimiento y la moderación:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parámetros de herramientas
tools, tool_choice, parallel_tool_calls, max_turns
Estos parámetros controlan el uso de herramientas (web_search, code_interpreter, funciones personalizadas). Se cubren en detalle en la sección «Herramientas» (lecciones 9-12).
Resumen de parámetros
| Parámetro | Tipo | Por defecto | Uso |
|---|---|---|---|
model | string | obligatorio | Identificador del modelo |
input | string/array | obligatorio | Prompt del usuario |
instructions | string | null | Prompt del sistema |
temperature | number | — | 0,7 recomendado; limitado a 1 |
top_p | number | 0,95 | Muestreo de núcleo |
max_output_tokens | integer | 128.000 | Límite de respuesta visible |
reasoning | object | null | Esfuerzo de razonamiento |
store | boolean | null | Persistencia de 30 días |
stream | boolean | false | Streaming SSE |
user | string | null | ID de usuario final |
Puntos clave
- xAI recomienda
temperatureen 0,7 ytop_pen 0,95, establecidos explícitamente max_output_tokenslimita solo la respuesta visible, excluyendo el razonamientostore: truepersiste la respuesta durante 30 días para el encadenamiento de conversacionesreasoning.effortte permite escalar la reflexión del modelo según la complejidad de la tarea- El parámetro
userayuda con el seguimiento y la moderación por parte de xAI