Shranjevanje in trajnost odgovorov
Na tej strani
Nadzoruj življenjsko dobo svojih podatkov
API za odgovore vključuje vgrajeno shranjevanje: z nastavitvijo store: true strežniki xAI hranijo tvoje odgovore 30 dni. Kadar koli jih lahko pridobiš, ogledaš ali izbrišeš z uporabo namenskih končnih točk.
store: true proti store: false
Način shranjevanja (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Odgovor ostane shranjen 30 dni. Lahko:
- Se nanj sklicuješ z
previous_response_id, da nadaljuješ pogovor - Ga kasneje pridobiš z
GET /v1/responses/{id} - Ga izbrišeš z
DELETE /v1/responses/{id}
Zasebni način (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Odgovor se po zahtevi ne shrani. Rezultat sicer prejmeš v HTTP-odgovoru, a nato postane nedostopen. Povezovanje prek previous_response_id ni mogoče.
Uporabi store: false za občutljive podatke ali kadar pogovora ne potrebuješ nadaljevati.
Pridobivanje shranjenega odgovora
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API vrne celoten objekt odgovora, identičen tistemu, prejetemu ob ustvarjanju. To je uporabno za:
- Revizijo preteklih interakcij
- Rekonstrukcijo zgodovine pogovora
- Naknadno preverjanje stroškov
V Pythonu
# Pridobi shranjen odgovor
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. Če se drugi povezani odgovori sklicujejo na ta odgovor prek previous_response_id, ustrezen kontekst ne bo več na voljo.
V Pythonu
client.responses.delete("resp-abc123")
Primeri uporabe shranjevanja
Klepetalni bot z zgodovino
Omogoči store: true za vse zahteve. Uporabnik lahko nadaljuje pogovor tudi po zaprtju brskalnika, dokler hraniš zadnji response_id.
Analiza občutljivih podatkov
Za zahteve, ki vsebujejo osebne ali zaupne podatke, uporabi store: false. Odgovor se obdela v pomnilniku in se ne shrani trajno.
Revizija in skladnost
Pridobi shranjene odgovore za gradnjo revizijskih dnevnikov. Izbriši jih, ko niso več potrebni, da izpolniš politike hrambe podatkov.
Obdobje hrambe
Shranjeni odgovori se samodejno izbrišejo po 30 dneh. Tega obdobja prek API-ja ne moreš podaljšati. Če potrebuješ daljšo zgodovino, odgovore shrani v svojo bazo podatkov.
Ključne ugotovitve
store: trueohrani odgovor 30 dni –store: falsene shrani ničesarGET /v1/responses/{id}pridobi shranjen odgovorDELETE /v1/responses/{id}trajno izbriše odgovor- Povezovanje prek
previous_response_idzahteva, da je odgovor shranjen - Odgovori se samodejno počistijo po 30 dneh
- Za občutljive podatke uporabi
store: false