Ukládání a perzistence odpovědí
Na této stránce
Ovládej životnost svých dat
API pro odpovědi obsahuje vestavěné úložiště: při nastavení store: true uchovávají servery xAI tvé odpovědi po dobu 30 dnů. Můžeš je kdykoli načíst, zobrazit nebo smazat pomocí vyhrazených endpointů.
store: true vs store: false
Režim s ukládáním (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Odpověď přetrvává 30 dnů. Můžeš:
- Odkazovat na ni pomocí
previous_response_idpro pokračování v konverzaci - Získat ji později pomocí
GET /v1/responses/{id} - Smazat ji pomocí
DELETE /v1/responses/{id}
Soukromý režim (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Odpověď se po zpracování požadavku neuchovává. Výsledek sice obdržíš v HTTP odpovědi, ale následně se stane nedostupným. Řetězení prostřednictvím previous_response_id není možné.
Použij store: false pro citlivá data nebo když nepotřebuješ v konverzaci pokračovat.
Načtení uložené odpovědi
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API vrátí kompletní objekt odpovědi, totožný s tím, který jsi obdržel při jejím vytvoření. To se hodí pro:
- Audit minulých interakcí
- Rekonstrukci historie konverzace
- Následnou verifikaci nákladů
V Pythonu
# Načtení uložené odpovědi
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")
Smazání odpovědi
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Smazání je trvalé. Pokud jiné řetězené odpovědi odkazují na tuto odpověď prostřednictvím previous_response_id, příslušný kontext již nebude dostupný.
V Pythonu
client.responses.delete("resp-abc123")
Využití úložiště
Chatbot s historií
Povol store: true pro všechny požadavky. Uživatel může obnovit svou konverzaci i po zavření prohlížeče, pokud uchováváš poslední response_id.
Analýza citlivých dat
Pro požadavky obsahující osobní nebo důvěrné údaje použij store: false. Odpověď se zpracuje v paměti a není trvale uložena.
Audit a soulad s předpisy
Načti uložené odpovědi pro vytvoření auditních záznamů. Až přestanou být potřebné, smaž je, abys dodržel zásady pro uchovávání dat.
Doba uchování
Uložené odpovědi se automaticky smažou po 30 dnech. Tuto lhůtu nelze prostřednictvím API prodloužit. Pokud potřebuješ delší historii, ukládej odpovědi do vlastní databáze.
Klíčové poznatky
store: trueuchová odpověď po dobu 30 dnů –store: falsenic neuchováváGET /v1/responses/{id}načte uloženou odpověďDELETE /v1/responses/{id}trvale smaže odpověď- Řetězení přes
previous_response_idvyžaduje, aby byla odpověď uložena - Odpovědi se automaticky vymažou po 30 dnech
- Pro citlivá data použij
store: false