GET și DELETE: Gestionarea răspunsurilor
Pe această pagină
Dincolo de creare
API-ul Responses nu se limitează la crearea de răspunsuri. Două endpoint-uri complementare vă permit să preluați și să ștergeți răspunsurile stocate. Aceste operațiuni sunt esențiale pentru construirea unor aplicații robuste cu gestionarea istoricului.
GET /v1/responses/{id}
Preluarea unui răspuns
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API-ul returnează exact același obiect JSON ca în timpul creării:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Cazuri de utilizare practice
Reluarea conversației: Aplicația dumneavoastră stochează ultimul response_id în sesiunea utilizatorului. La reconectare, preluați răspunsul pentru a afișa contextul anterior.
# Utilizatorul revine după o pauză
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Afișează ultimul schimb
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Continuă conversația
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Auditarea costurilor: Iterați prin răspunsurile stocate pentru a analiza consumul pe utilizator sau funcționalitate.
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}")
Gestionarea erorilor
Dacă răspunsul nu există (a fost șters sau a expirat), API-ul returnează o eroare 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Gestionați acest caz în codul dumneavoastră:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Începe o nouă conversație
DELETE /v1/responses/{id}
Ștergerea unui răspuns
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Ștergerea returnează un status 200 în caz de succes. Operațiunea este ireversibilă.
Impactul asupra conversațiilor înlănțuite
Când ștergeți un răspuns referențiat de altele prin previous_response_id, contextul acelui răspuns dispare din lanț. Răspunsurile ulterioare nu sunt șterse, dar își pierd accesul la contextul anterior.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Dacă ștergeți resp-2, resp-3 și resp-4 există în continuare, dar contextul de la resp-1 și resp-2 nu mai este accesibil pentru noile cereri înlănțuite.
Curățare automată
Pentru aplicațiile de producție, implementați o curățare periodică:
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 # Deja șters sau expirat
Cele mai bune practici
- Stocați ID-urile: păstrați
response_id-urile în baza de date împreună cu metadatele conversației - Curățați regulat: nu așteptați expirarea automată de 30 de zile pentru datele sensibile
- Gestionați erorile 404: un răspuns poate dispărea între cereri (expirare, ștergere manuală)
- Documentați lanțurile: pentru depanare, urmăriți link-urile
previous_response_iddintre răspunsurile dumneavoastră
Puncte cheie
GET /v1/responses/{id}preia un răspuns cu tot conținutul și metadatele saleDELETE /v1/responses/{id}șterge permanent un răspuns – operațiune ireversibilă- Ștergerea unui răspuns intermediar întrerupe contextul lanțului de conversație
- Gestionați erorile 404: răspunsurile expiră automat după 30 de zile
- Păstrați
response_id-urile în propria bază de date pentru trasabilitate