Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Abrufen und Löschen: Antworten verwalten

Lektion 7 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Über die Erstellung hinaus
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Best Practices
  5. Kernaussagen

Über die Erstellung hinaus

Die Responses API beschränkt sich nicht auf die Erstellung von Antworten. Zwei ergänzende Endpunkte ermöglichen das Abrufen und Löschen gespeicherter Antworten. Diese Operationen sind unerlässlich für den Aufbau robuster Anwendungen mit Verwaltung der Historie.

GET /v1/responses/{id}

Antwort abrufen

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

Die API gibt das exakt gleiche JSON-Objekt zurück wie bei der Erstellung:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Praktische Anwendungsfälle

Wiederaufnahme einer Konversation: Ihre Anwendung speichert die letzte response_id in der Benutzersitzung. Beim Wiederverbinden wird die Antwort abgerufen, um den vorherigen Kontext anzuzeigen.

# Benutzer kehrt nach einer Pause zurück
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Die letzte Nachricht anzeigen
print(f"Letzte Antwort: {previous.output[0].content[0].text[:200]}...")

# Die Konversation fortsetzen
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Wo waren wir?",
    previous_response_id=last_response_id
)

Kostenprüfung: Durchlaufen Sie Ihre gespeicherten Antworten, um den Verbrauch nach Benutzer oder Funktion zu analysieren.

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"Kosten: ${cost_usd:.6f} | Eingabe: {input_tokens} | Ausgabe: {output_tokens}")

Fehlerbehandlung

Wenn die Antwort nicht existiert (gelöscht oder abgelaufen), gibt die API einen 404-Fehler zurück:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Behandeln Sie diesen Fall in Ihrem Code:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Antwort nicht gefunden: {e}")
    # Starten Sie eine neue Konversation

DELETE /v1/responses/{id}

Antwort löschen

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

Das Löschen gibt bei Erfolg einen 200-Status zurück. Die Operation ist unwiderruflich.

Auswirkungen auf verkettete Konversationen

Wenn Sie eine Antwort löschen, die von anderen über previous_response_id referenziert wird, verschwindet der Kontext dieser Antwort aus der Kette. Nachfolgende Antworten werden nicht gelöscht, verlieren aber den Zugriff auf den vorherigen Kontext.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ gelöscht

Wenn Sie resp-2 löschen, existieren resp-3 und resp-4 weiterhin, doch der Kontext aus resp-1 und resp-2 ist für neue verkettete Anfragen nicht mehr zugänglich.

Automatisierte Bereinigung

Implementieren Sie für Produktionsanwendungen eine regelmäßige Bereinigung:

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"Gelöscht: {rid}")
        except Exception:
            pass  # Bereits gelöscht oder abgelaufen

Best Practices

  • IDs speichern: Speichern Sie response_ids in Ihrer Datenbank zusammen mit den Metadaten der Konversation
  • Regelmäßig bereinigen: Warten Sie nicht auf die automatische Ablaufzeit von 30 Tagen für sensible Daten
  • 404-Fehler behandeln: Eine Antwort kann zwischen Anfragen verschwinden (Ablauf, manuelles Löschen)
  • Ihre Ketten dokumentieren: Zur Fehlerbehebung können Sie die previous_response_id-Verknüpfungen zwischen Ihren Antworten nachverfolgen

Kernaussagen

  • GET /v1/responses/{id} ruft eine Antwort mit allen Inhalten und Metadaten ab
  • DELETE /v1/responses/{id} löscht eine Antwort dauerhaft – es handelt sich um eine unwiderrufliche Operation
  • Das Löschen einer Zwischenantwort unterbricht den Kontext der Konversationskette
  • Behandeln Sie 404-Fehler: Antworten laufen automatisch nach 30 Tagen ab
  • Speichern Sie response_ids in Ihrer eigenen Datenbank zur Nachverfolgbarkeit