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

GET y DELETE: Gestión de respuestas

Lección 7 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Más allá de la creación
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Buenas prácticas
  5. Puntos clave

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_id en 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_id entre 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_id en tu propia base de datos para garantizar la trazabilidad.