Vastuste salvestamine ja püsivus
Sellel lehel
Juhi oma andmete eluiga
Vastuste API sisaldab sisseehitatud salvestusruumi: parameetriga store: true hoiavad xAI serverid sinu vastuseid 30 päeva. Saad neid igal ajal spetsiaalsete otspunktide abil kätte saada, vaadata ja kustutada.
store: true vs store: false
Salvestatud režiim (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Vastus säilib 30 päeva. Saad:
- Viidata sellele
previous_response_idabil vestluse jätkamiseks - Hiljem selle kätte saada päringuga
GET /v1/responses/{id} - Selle kustutada päringuga
DELETE /v1/responses/{id}
Privaatne režiim (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Vastust ei hoita pärast päringu lõppu alles. Saad tulemuse kätte HTTP-vastuses, kuid see muutub seejärel kättesaamatuks. Aheldamine previous_response_id kaudu pole võimalik.
Kasuta store: false tundlike andmete korral või siis, kui sul pole vaja vestlust jätkata.
Salvestatud vastuse kättesaamine
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API tagastab täieliku vastuse objekti, mis on identne loomise ajal saaduga. See on kasulik:
- Varasemate suhtluste auditeerimiseks
- Vestlusajaloo taastamiseks
- Kulude järelkontrolliks
Pythonis
# Salvestatud vastuse kättesaamine
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")
Vastuse kustutamine
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Kustutamine on pöördumatu. Kui teised aheldatud vastused viitavad sellele vastusele previous_response_id kaudu, ei ole vastav kontekst enam kättesaadav.
Pythonis
client.responses.delete("resp-abc123")
Salvestamise kasutusjuhud
Ajalooga vestlusrobot
Luba store: true kõigile päringutele. Kasutaja saab vestlust jätkata isegi pärast brauseri sulgemist, kui hoiad alles viimase response_id.
Tundlike andmete analüüs
Kasuta store: false päringute puhul, mis sisaldavad isiku- või konfidentsiaalseid andmeid. Vastus töödeldakse mälus ja seda ei salvestata püsivalt.
Audit ja vastavus
Hangi salvestatud vastused auditilogide koostamiseks. Kustuta need, kui need pole enam vajalikud, et järgida andmete säilitamise poliitikat.
Säilitusperiood
Salvestatud vastused kustutatakse automaatselt 30 päeva pärast. Seda perioodi ei saa API kaudu pikendada. Kui vajad pikemat ajalugu, salvesta vastused oma andmebaasi.
Peamised punktid
store: truesäilitab vastuse 30 päevaks –store: falseei jäta midagi allesGET /v1/responses/{id}toob kätte salvestatud vastuseDELETE /v1/responses/{id}kustutab vastuse pöördumatult- Aheldamine
previous_response_idkaudu eeldab vastuse salvestamist - Vastused puhastatakse automaatselt 30 päeva pärast
- Kasuta
store: falsetundlike andmete puhul