Ir al contenido principal
Español— Elegir un idioma
Menú

Parámetros de solicitud

Lección 3 de 16 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Control del comportamiento del modelo
  2. Parámetros de generación
  3. Parámetros de conversación
  4. Parámetros de herramientas
  5. Resumen de parámetros
  6. Puntos clave

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_p 0,95 por defecto; max_output_tokens limitado 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 con previous_response_id
  • false: 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ámetroTipoPor defectoUso
modelstringobligatorioIdentificador del modelo
inputstring/arrayobligatorioPrompt del usuario
instructionsstringnullPrompt del sistema
temperaturenumber—0,7 recomendado; limitado a 1
top_pnumber0,95Muestreo de núcleo
max_output_tokensinteger128.000Límite de respuesta visible
reasoningobjectnullEsfuerzo de razonamiento
storebooleannullPersistencia de 30 días
streambooleanfalseStreaming SSE
userstringnullID de usuario final

Puntos clave

  • xAI recomienda temperature en 0,7 y top_p en 0,95, establecidos explícitamente
  • max_output_tokens limita solo la respuesta visible, excluyendo el razonamiento
  • store: true persiste la respuesta durante 30 días para el encadenamiento de conversaciones
  • reasoning.effort te permite escalar la reflexión del modelo según la complejidad de la tarea
  • El parámetro user ayuda con el seguimiento y la moderación por parte de xAI