Pohrana i trajnost odgovora
Na ovoj stranici
Upravljaj vijekom trajanja svojih podataka
Responses API uključuje ugrađenu pohranu: uz store: true, xAI poslužitelji čuvaju tvoje odgovore 30 dana. Možeš ih dohvatiti, pregledavati i brisati u bilo kojem trenutku pomoću namjenskih krajnjih točaka.
store: true naspram store: false
Način pohrane (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Odgovor se zadržava 30 dana. Možeš:
- Referencirati ga s
previous_response_idza nastavak razgovora - Kasnije ga dohvatiti s
GET /v1/responses/{id} - Obrisati ga s
DELETE /v1/responses/{id}
Privatni način (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Odgovor se ne čuva nakon zahtjeva. I dalje primaš rezultat u HTTP odgovoru, ali on nakon toga postaje nedostupan. Lančanje putem previous_response_id nije moguće.
Koristi store: false za osjetljive podatke ili kada ne trebaš nastaviti razgovor.
Dohvaćanje pohranjenog odgovora
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API vraća kompletan objekt odgovora, identičan onome primljenom tijekom izrade. Ovo je korisno za:
- Reviziju prošlih interakcija
- Rekonstrukciju povijesti razgovora
- Provjeru troškova naknadno
U Pythonu
# 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")
Brisanje odgovora
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Brisanje je trajno. Ako drugi povezani odgovori referenciraju ovaj odgovor putem previous_response_id, odgovarajući kontekst više neće biti dostupan.
U Pythonu
client.responses.delete("resp-abc123")
Slučajevi uporabe pohrane
Chatbot s poviješću
Omogući store: true za sve zahtjeve. Korisnik može nastaviti razgovor čak i nakon zatvaranja preglednika, sve dok čuvaš zadnji response_id.
Analiza osjetljivih podataka
Koristi store: false za zahtjeve koji sadrže osobne ili povjerljive podatke. Odgovor se obrađuje u memoriji i ne pohranjuje trajno.
Revizija i usklađenost
Dohvati pohranjene odgovore kako bi izgradio revizijske zapise. Obriši ih kada više nisu potrebni kako bi bio u skladu s politikama zadržavanja.
Razdoblje zadržavanja
Pohranjeni odgovori se automatski brišu nakon 30 dana. Ne možeš produžiti ovo razdoblje putem API-ja. Ako ti treba duža povijest, spremi odgovore u svoju bazu podataka.
Ključne točke
store: truetrajno pohranjuje odgovor na 30 dana —store: falsene čuva ništaGET /v1/responses/{id}dohvaća pohranjeni odgovorDELETE /v1/responses/{id}trajno briše odgovor- Lančanje putem
previous_response_idzahtijeva da odgovor bude pohranjen - Odgovori se automatski čiste nakon 30 dana
- Koristi
store: falseza osjetljive podatke