GET och DELETE: Hantera svar
På denna sida
Mer än att skapa
Responses API är inte begränsat till att bara skapa svar. Två kompletterande slutpunkter låter dig hämta och radera lagrade svar. Dessa operationer är avgörande för att bygga robusta applikationer med historikhantering.
GET /v1/responses/{id}
Hämta ett svar
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API:et returnerar exakt samma JSON-objekt som vid skapandet:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktiska användningsområden
Återuppta konversation: Din applikation lagrar det senaste response_id i användarsessionen. Vid återanslutning hämtar du svaret för att visa tidigare kontext.
# Användaren återvänder efter en paus
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Visa det senaste utbytet
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Fortsätt konversationen
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Granskning av kostnader: Iterera genom dina lagrade svar för att analysera förbrukningen per användare eller funktion.
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"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Felhantering
Om svaret inte finns (raderat eller utgånget) returnerar API:et ett 404-fel:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Hantera detta fall i din kod:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Starta en ny konversation
DELETE /v1/responses/{id}
Radera ett svar
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Radering returnerar status 200 vid lyckat utförande. Operationen är oåterkallelig.
Påverkan på kedjade konversationer
När du raderar ett svar som refereras till av andra via previous_response_id, försvinner det svarets kontext från kedjan. Efterföljande svar raderas inte, men de förlorar åtkomsten till den tidigare kontexten.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Om du raderar resp-2 finns resp-3 och resp-4 fortfarande kvar, men kontexten från resp-1 och resp-2 är inte längre tillgänglig för nya kedjade förfrågningar.
Automatiserad rensning
För produktionsapplikationer bör du implementera periodisk rensning:
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"Deleted: {rid}")
except Exception:
pass # Redan raderad eller utgången
Bästa praxis
- Lagra ID:n: Spara
response_idi din databas tillsammans med konversationsmetadata. - Rensa regelbundet: Vänta inte på den automatiska utgången efter 30 dagar för känslig data.
- Hantera 404-fel: Ett svar kan försvinna mellan förfrågningar (utgång, manuell radering).
- Dokumentera dina kedjor: För felsökning, spåra länkarna
previous_response_idmellan dina svar.
Viktiga punkter
GET /v1/responses/{id}hämtar ett svar med allt dess innehåll och metadata.DELETE /v1/responses/{id}raderar ett svar permanent – en oåterkallelig operation.- Att radera ett mellanliggande svar bryter kontexten i konversationskedjan.
- Hantera 404-fel: svar löper ut automatiskt efter 30 dagar.
- Behåll
response_idi din egen databas för spårbarhet.