Abrufen und Löschen: Antworten verwalten
Auf dieser Seite
Ü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 abDELETE /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