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

Stocarea și persistența răspunsurilor

Lecția 6 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Controlați durata de viață a datelor dumneavoastră
  2. store: true vs store: false
  3. Recuperarea unui răspuns stocat
  4. Ștergerea unui răspuns
  5. Cazuri de utilizare pentru stocare
  6. Perioada de retenție
  7. Puncte cheie

Controlați durata de viață a datelor dumneavoastră

API-ul Responses include o funcționalitate de stocare integrată: cu store: true, serverele xAI păstrează răspunsurile dumneavoastră timp de 30 de zile. Le puteți recupera, vizualiza și șterge în orice moment folosind endpoint-uri dedicate.

store: true vs store: false

Modul stocat (store: true)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Write a summary of this project.",
  "store": true
}

Răspunsul persistă timp de 30 de zile. Puteți:

  • Să îl referenciați folosind previous_response_id pentru a continua conversația
  • Să îl recuperați ulterior cu GET /v1/responses/{id}
  • Să îl ștergeți cu DELETE /v1/responses/{id}

Modul privat (store: false)

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this confidential data.",
  "store": false
}

Răspunsul nu este păstrat după finalizarea cererii. Primiți totuși rezultatul în răspunsul HTTP, dar acesta devine inaccesibil ulterior. Înlănțuirea prin previous_response_id nu este posibilă.

Folosiți store: false pentru date sensibile sau când nu aveți nevoie să continuați conversația.

Recuperarea unui răspuns stocat

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

API-ul returnează obiectul complet al răspunsului, identic cu cel primit în timpul creării. Acest lucru este util pentru:

  • Auditarea interacțiunilor anterioare
  • Reconstruirea istoricului unei conversații
  • Verificarea costurilor post-factum

În Python

# Retrieve a stored response
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")

Ștergerea unui răspuns

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

Ștergerea este permanentă. Dacă alte răspunsuri înlănțuite fac referire la acest răspuns prin previous_response_id, contextul corespunzător nu va mai fi disponibil.

În Python

client.responses.delete("resp-abc123")

Cazuri de utilizare pentru stocare

Chatbot cu istoric

Activați store: true pentru toate cererile. Utilizatorul poate relua conversația chiar și după închiderea browserului, atâta timp cât păstrați ultimul response_id.

Analiza datelor sensibile

Folosiți store: false pentru cererile care conțin date personale sau confidențiale. Răspunsul este procesat în memorie și nu este persistat.

Audit și conformitate

Recuperați răspunsurile stocate pentru a construi jurnale de audit. Ștergeți-le atunci când nu mai sunt necesare pentru a respecta politicile de retenție.

Perioada de retenție

Răspunsurile stocate sunt șterse automat după 30 de zile. Nu puteți extinde această perioadă prin API. Dacă aveți nevoie de un istoric mai lung, salvați răspunsurile în propria bază de date.

Puncte cheie

  • store: true persistă răspunsul timp de 30 de zile — store: false nu păstrează nimic
  • GET /v1/responses/{id} recuperează un răspuns stocat
  • DELETE /v1/responses/{id} șterge permanent un răspuns
  • Înlănțuirea prin previous_response_id necesită ca răspunsul să fie stocat
  • Răspunsurile sunt eliminate automat după 30 de zile
  • Folosiți store: false pentru datele sensibile