Estado heredado y el principio sin estado
En esta página
Actualizado el 3 de noviembre de 2026 según las mejores prácticas de xAI: xAI clasifica ahora Chat Completions como obsoleto y recomienda la API de Responses para los modelos de razonamiento de Grok. La razón concreta es que Chat Completions carece de un campo para el razonamiento cifrado del modelo, por lo que cada conversación de varios turnos o llamada a herramientas pierde el razonamiento de los turnos anteriores. Las nuevas funciones también llegan primero a la API de Responses. Fuentes: Mejores prácticas de xAI · Chat Completions (heredado).
El punto final de Chat Completions en el ecosistema xAI
La API de xAI ofrece dos puntos finales principales para interactuar con los modelos de Grok: la API de Responses (punto final principal) y el punto final de Chat Completions. Este último está marcado como heredado: sigue siendo totalmente funcional, pero las nuevas funciones tienen ahora prioridad para la API de Responses.
¿Por qué preocuparse entonces? Porque Chat Completions sigue siendo el punto final más adoptado en el ecosistema. Todos los SDK de OpenAI existentes, marcos como LangChain o LlamaIndex, y miles de tutoriales utilizan este formato. Si estás migrando desde otro proveedor o trabajando con herramientas de terceros, es probable que este sea el punto final que uses primero.
Un punto final sin estado: envía todo en cada solicitud
El principio fundamental de Chat Completions es que es sin estado: el servidor no mantiene ningún historial de conversación. Con cada llamada, debes incluir el historial completo de mensajes anteriores en tu solicitud.
En concreto, esto significa que para una conversación con 10 intercambios, tu undécima solicitud debe contener los 10 mensajes anteriores (usuario + asistente) más el nuevo mensaje. Tu aplicación se encarga de gestionar este historial.
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "Eres un asistente útil."},
{"role": "user", "content": "¡Hola!"},
{"role": "assistant", "content": "¡Hola! ¿Cómo puedo ayudarte?"},
{"role": "user", "content": "Explícame el aprendizaje profundo."}
]
}
En este ejemplo, los tres primeros mensajes representan el historial de la conversación. Solo el último es el nuevo mensaje del usuario. El modelo necesita todo este contexto para producir una respuesta coherente.
Implicaciones prácticas
Este enfoque sin estado tiene varias implicaciones:
- Control total: tú decides exactamente qué mensajes se envían al modelo. Puedes filtrar, resumir o modificar el historial antes de cada llamada.
- Coste proporcional: cada solicitud se factura por todos los tokens enviados, incluido el historial. Cuanto más larga sea la conversación, más costará cada intercambio.
- Sin persistencia en el servidor: no se almacenan datos en el lado de xAI entre solicitudes. Esto es una ventaja para la privacidad, pero requiere que gestiones la persistencia por tu cuenta.
Comparación con la API de Responses
La API de Responses, sin embargo, es con estado: mantiene el historial en el servidor mediante previous_response_id. No necesitas reenviar los mensajes anteriores; basta con un identificador simple. Las respuestas pueden almacenarse hasta 30 días con store: true.
La elección entre ambos depende de tu caso de uso. Si trabajas con un SDK de OpenAI existente o migras desde otro proveedor, Chat Completions es el punto de partida lógico. Para un proyecto nuevo, se recomienda la API de Responses.
Puntos clave
- Chat Completions está marcado como heredado, pero sigue siendo totalmente funcional y compatible con el ecosistema de OpenAI
- El punto final es sin estado: debes reenviar el historial completo en cada solicitud
- El coste de cada solicitud incluye todos los tokens del historial
- La API de Responses ofrece una alternativa con estado con persistencia en el servidor
- Para los modelos de razonamiento, se recomienda un tiempo de espera de 3600 segundos