Ukladanie a perzistencia odpovedí
Na tejto strane
Kontroluj životnosť svojich dát
API Responses má vstavané úložisko: pri nastavení store: true servery xAI uchovávajú tvoje odpovede počas 30 dní. Kedykoľvek ich môžeš načítať, zobraziť alebo odstrániť pomocou vyhradených endpointov.
store: true vs store: false
Režim s ukladaním (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Odpoveď zostane uložená 30 dní. Môžeš:
- Odvolať sa na ňu pomocou
previous_response_ida pokračovať v konverzácii - Neskôr ju načítať cez
GET /v1/responses/{id} - Odstrániť ju cez
DELETE /v1/responses/{id}
Súkromný režim (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Odpoveď sa po spracovaní žiadosti neuchová. Výsledok dostaneš v HTTP odpovedi, no následne sa stane nedostupným. Reťazenie cez previous_response_id nie je možné.
Použi store: false pre citlivé údaje alebo keď nepotrebuješ v konverzácii pokračovať.
Načítanie uloženej odpovede
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API vráti kompletný objekt odpovede, totožný s tým, ktorý si dostal pri vytvorení. Hodí sa to na:
- Audit minulých interakcií
- Rekonštrukciu histórie konverzácie
- Dodatočné overenie nákladov
V Pythone
# Načítanie uloženej odpovede
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")
Odstránenie odpovede
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Odstránenie je trvalé. Ak iné reťazené odpovede odkazujú na túto odpoveď cez previous_response_id, príslušný kontext už nebude dostupný.
V Pythone
client.responses.delete("resp-abc123")
Prípady použitia úložiska
Chatbot s históriou
Povoľ store: true pre všetky požiadavky. Používateľ môže obnoviť konverzáciu aj po zatvorení prehliadača, pokiaľ si uchováš posledné response_id.
Analýza citlivých údajov
Pre požiadavky obsahujúce osobné alebo dôverné údaje použi store: false. Odpoveď sa spracuje v pamäti a neuloží sa trvalo.
Audit a súlad s predpismi
Načítavaj uložené odpovede na vytváranie auditných záznamov. Keď už nie sú potrebné, odstráň ich, aby si dodržal zásady uchovávania údajov.
Doba uchovávania
Uložené odpovede sa automaticky odstránia po 30 dňoch. Túto lehotu nie je možné cez API predĺžiť. Ak potrebuješ dlhšiu históriu, ulož si odpovede do vlastnej databázy.
Kľúčové poznatky
store: trueuchová odpoveď 30 dní –store: falseneuchová ničGET /v1/responses/{id}načíta uloženú odpoveďDELETE /v1/responses/{id}trvalo odstráni odpoveď- Reťazenie cez
previous_response_idvyžaduje, aby bola odpoveď uložená - Odpovede sa automaticky vymažú po 30 dňoch
- Pre citlivé údaje použi
store: false