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

¿Por qué la API de Responses?

Lección 1 de 16 Actualizado el 28 de julio de 2026 Desarrollador
En esta página
  1. Un nuevo endpoint para nuevas ambiciones
  2. Con estado frente a sin estado: el cambio fundamental
  3. Funcionalidades exclusivas
  4. ¿Cuándo usar cada endpoint?
  5. Puntos clave

Un nuevo endpoint para nuevas ambiciones

La API de Responses es el nuevo endpoint principal de xAI para interactuar con los modelos Grok. Si ya estás familiarizado con el endpoint de Chat Completions (compatible con OpenAI), probablemente te preguntes por qué xAI ha creado un segundo endpoint. La respuesta se resume en una palabra: evolución.

Chat Completions sigue disponible para garantizar la compatibilidad con versiones anteriores de los SDK de OpenAI, pero xAI incorpora todas las nuevas funciones de la plataforma primero en la API de Responses. Este es el endpoint en el que merece la pena invertir tu tiempo de aprendizaje.

Con estado frente a sin estado: el cambio fundamental

La diferencia más importante entre ambos endpoints radica en cómo gestionan el estado de la conversación.

Chat Completions (sin estado)

Con Chat Completions, cada solicitud es independiente. Debes enviar todo el historial de la conversación en cada llamada:

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are an assistant."},
    {"role": "user", "content": "Hello"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Tell me about AI."}
  ]
}

Cuanto más larga sea la conversación, mayor será la solicitud. Tú gestionas el contexto por tu cuenta.

API de Responses (con estado)

Con la API de Responses, el servidor de xAI conserva el historial. Simplemente envías tu nuevo mensaje y una referencia a la respuesta anterior:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Tell me about AI.",
  "previous_response_id": "resp-abc123"
}

El servidor reconstruye el contexto completo por ti. Menos datos que transmitir, menos código que escribir y menos errores posibles.

Con estado
Historial en el servidor
30 días
Retención de respuestas
4
Herramientas integradas en el servidor
128
Máximo de herramientas por solicitud

Funcionalidades exclusivas

Varias funcionalidades están disponibles únicamente a través de la API de Responses:

  • Herramientas nativas del servidor: web_search, x_search y code_interpreter se ejecutan directamente en los servidores de xAI, sin necesidad de configuración por tu parte.
  • Encadenamiento de conversaciones: mediante previous_response_id, el modelo conserva todo el contexto sin que tengas que reenviarlo.
  • Almacenamiento persistente: con store: true, tus respuestas se conservan durante 30 días y pueden recuperarse mediante GET.
  • Razonamiento cifrado: recupera el razonamiento interno de los modelos recientes de Grok en forma cifrada para reutilizarlo en solicitudes posteriores.
  • Seguimiento granular de costes: cost_in_nano_usd en cada respuesta para un control preciso de tu gasto.

¿Cuándo usar cada endpoint?

Utiliza Chat Completions solo si estás migrando un proyecto existente desde la API de OpenAI y no puedes modificar tu código de inmediato.

Para cualquier proyecto nuevo, utiliza la API de Responses. Es más sencilla, más potente y recibirá todas las mejoras futuras de la plataforma xAI.

Puntos clave

  • La API de Responses es el endpoint principal de xAI; Chat Completions es legado.
  • Es con estado: el servidor gestiona el historial de la conversación.
  • Ofrece herramientas nativas del servidor (búsqueda web, X, intérprete de código).
  • El almacenamiento persistente te permite reanudar conversaciones hasta 30 días después.
  • Cualquier proyecto nuevo debe utilizar la API de Responses.