Almacenamiento y persistencia de respuestas
En esta página
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_idpara 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: truepersiste la respuesta durante 30 días;store: falseno conserva nadaGET /v1/responses/{id}recupera una respuesta almacenadaDELETE /v1/responses/{id}elimina permanentemente una respuesta- El encadenamiento mediante
previous_response_idrequiere que la respuesta esté almacenada - Las respuestas se purgan automáticamente pasados 30 días
- Utiliza
store: falsepara datos sensibles