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

Almacenamiento y persistencia de respuestas

Lección 6 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Controla la vida útil de tus datos
  2. store: true frente a store: false
  3. Recuperar una respuesta almacenada
  4. Eliminar una respuesta
  5. Casos de uso del almacenamiento
  6. Periodo de retención
  7. Puntos clave

Controla la vida útil de tus datos

La API de Responses incluye almacenamiento integrado: con store: true, los servidores de xAI conservan tus respuestas durante 30 días. Puedes recuperarlas, consultarlas y eliminarlas en cualquier momento mediante endpoints dedicados.

store: true frente a store: false

Modo almacenado (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

La respuesta persiste durante 30 días. Puedes:

  • Hacer referencia a ella con previous_response_id para continuar la conversación
  • Recuperarla más tarde con GET /v1/responses/{id}
  • Eliminarla con DELETE /v1/responses/{id}

Modo privado (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

La respuesta no se conserva tras la solicitud. Sigues recibiendo el resultado en la respuesta HTTP, pero queda inaccesible inmediatamente después. No es posible encadenar llamadas mediante previous_response_id.

Utiliza store: false para datos sensibles o cuando no necesites continuar la conversación.

Recuperar una respuesta almacenada

curl https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

La API devuelve el objeto de respuesta completo, idéntico al recibido durante la creación. Esto resulta útil para:

  • Auditar interacciones pasadas
  • Reconstruir un historial de conversación
  • Verificar costes a posteriori

En Python

# Recuperar una respuesta almacenada
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Coste: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

Eliminar una respuesta

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

La eliminación es permanente. Si otras respuestas encadenadas hacen referencia a esta mediante previous_response_id, el contexto correspondiente dejará de estar disponible.

En Python

client.responses.delete("resp-abc123")

Casos de uso del almacenamiento

Chatbot con historial

Activa store: true para todas las solicitudes. El usuario puede reanudar su conversación incluso después de cerrar el navegador, siempre que conserves el último response_id.

Análisis de datos sensibles

Utiliza store: false para solicitudes que contengan datos personales o confidenciales. La respuesta se procesa en memoria y no se persiste.

Auditoría y cumplimiento normativo

Recupera las respuestas almacenadas para generar registros de auditoría. Elimínalas cuando ya no sean necesarias para cumplir con las políticas de retención.

Periodo de retención

Las respuestas almacenadas se eliminan automáticamente transcurridos 30 días. No puedes ampliar este periodo mediante la API. Si necesitas un historial más extenso, guarda las respuestas en tu propia base de datos.

Puntos clave

  • store: true persiste la respuesta durante 30 días; store: false no conserva nada
  • GET /v1/responses/{id} recupera una respuesta almacenada
  • DELETE /v1/responses/{id} elimina permanentemente una respuesta
  • El encadenamiento mediante previous_response_id requiere que la respuesta esté almacenada
  • Las respuestas se purgan automáticamente pasados 30 días
  • Utiliza store: false para datos sensibles