Stocarea și persistența răspunsurilor
Pe această pagină
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_idpentru 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: truepersistă răspunsul timp de 30 de zile —store: falsenu păstrează nimicGET /v1/responses/{id}recuperează un răspuns stocatDELETE /v1/responses/{id}șterge permanent un răspuns- Înlănțuirea prin
previous_response_idnecesită ca răspunsul să fie stocat - Răspunsurile sunt eliminate automat după 30 de zile
- Folosiți
store: falsepentru datele sensibile