Salt la conținutul principal
Română— Alege o limbă
Meniu

GET și DELETE: Gestionarea răspunsurilor

Lecția 7 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Dincolo de creare
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Cele mai bune practici
  5. Puncte cheie

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_id dintre răspunsurile dumneavoastră

Puncte cheie

  • GET /v1/responses/{id} preia un răspuns cu tot conținutul și metadatele sale
  • DELETE /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