Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Ukládání a perzistence odpovědí

Lekce 6 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Ovládej životnost svých dat
  2. store: true vs store: false
  3. Načtení uložené odpovědi
  4. Smazání odpovědi
  5. Využití úložiště
  6. Doba uchování
  7. Klíčové poznatky

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_id pro 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: true uchová odpověď po dobu 30 dnů – store: false nic 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_id vyžaduje, aby byla odpověď uložena
  • Odpovědi se automaticky vymažou po 30 dnech
  • Pro citlivá data použij store: false