GET y DELETE: Gestión de respuestas
En esta página
Más allá de la creación
La API de Responses no se limita a crear respuestas. Dos endpoints complementarios te permiten recuperar y eliminar respuestas almacenadas. Estas operaciones son esenciales para construir aplicaciones robustas con gestión del historial.
GET /v1/responses/{id}
Recuperar una respuesta
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
La API devuelve exactamente el mismo objeto JSON que durante la creación:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Casos de uso prácticos
Reanudación de conversaciones: tu aplicación almacena el último response_id en la sesión del usuario. Al reconectar, recupera la respuesta para mostrar el contexto anterior.
# El usuario vuelve tras una pausa
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Mostrar el último intercambio
print(f"Última respuesta: {previous.output[0].content[0].text[:200]}...")
# Continuar la conversación
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="¿Dónde nos habíamos quedado?",
previous_response_id=last_response_id
)
Auditoría de costes: itera sobre tus respuestas almacenadas para analizar el consumo por usuario o funcionalidad.
response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Coste: ${cost_usd:.6f} | Entrada: {input_tokens} | Salida: {output_tokens}")
Gestión de errores
Si la respuesta no existe (eliminada o caducada), la API devuelve un error 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Gestiona este caso en tu código:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Respuesta no encontrada: {e}")
# Iniciar una nueva conversación
DELETE /v1/responses/{id}
Eliminar una respuesta
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
La eliminación devuelve un estado 200 si tiene éxito. La operación es irreversible.
Impacto en conversaciones encadenadas
Cuando eliminas una respuesta a la que otras hacen referencia mediante previous_response_id, el contexto de dicha respuesta desaparece de la cadena. Las respuestas posteriores no se eliminan, pero pierden el acceso al contexto previo.
resp-1 → resp-2 → resp-3 → resp-4
↑ eliminada
Si eliminas resp-2, resp-3 y resp-4 siguen existiendo, pero el contexto de resp-1 y resp-2 ya no es accesible para nuevas solicitudes encadenadas.
Limpieza automatizada
Para aplicaciones en producción, implementa una limpieza periódica:
import datetime
def cleanup_old_responses(response_ids, max_age_days=7):
for rid in response_ids:
try:
resp = client.responses.retrieve(rid)
age = datetime.datetime.now().timestamp() - resp.created_at
if age > max_age_days * 86400:
client.responses.delete(rid)
print(f"Eliminada: {rid}")
except Exception:
pass # Ya eliminada o caducada
Buenas prácticas
- Almacena los ID: guarda los
response_iden tu base de datos junto con los metadatos de la conversación. - Limpia regularmente: no esperes a la caducidad automática de 30 días para datos sensibles.
- Gestiona los 404: una respuesta puede desaparecer entre solicitudes (caducidad, eliminación manual).
- Documenta tus cadenas: para depurar, rastrea los enlaces
previous_response_identre tus respuestas.
Puntos clave
GET /v1/responses/{id}recupera una respuesta con todo su contenido y metadatos.DELETE /v1/responses/{id}elimina permanentemente una respuesta; es una operación irreversible.- Eliminar una respuesta intermedia rompe el contexto de la cadena de conversación.
- Gestiona los errores 404: las respuestas caducan automáticamente tras 30 días.
- Mantén los
response_iden tu propia base de datos para garantizar la trazabilidad.