Przechowywanie i trwałość odpowiedzi
Na tej stronie
Kontroluj czas życia swoich danych
API Responses posiada wbudowany mechanizm przechowywania: dzięki parametrowi store: true, serwery xAI przechowują Twoje odpowiedzi przez 30 dni. Możesz je w dowolnym momencie pobrać, wyświetlić lub usunąć, korzystając z dedykowanych punktów końcowych.
store: true vs store: false
Tryb przechowywania (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Odpowiedź jest przechowywana przez 30 dni. Możesz:
- Odwołać się do niej za pomocą
previous_response_id, aby kontynuować rozmowę - Pobrać ją później, używając
GET /v1/responses/{id} - Usunąć ją, używając
DELETE /v1/responses/{id}
Tryb prywatny (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Odpowiedź nie jest zachowywana po zakończeniu żądania. Nadal otrzymujesz wynik w odpowiedzi HTTP, ale staje się on następnie niedostępny. Łańcuchowanie poprzez previous_response_id nie jest możliwe.
Użyj store: false dla danych wrażliwych lub gdy nie planujesz kontynuować rozmowy.
Pobieranie przechowanej odpowiedzi
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API zwraca kompletny obiekt odpowiedzi, identyczny z tym otrzymanym podczas jej tworzenia. Przydaje się to do:
- Audytu przeszłych interakcji
- Rekonstrukcji historii rozmowy
- Weryfikacji kosztów post factum
W Pythonie
# Pobierz przechowaną odpowiedź
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")
Usuwanie odpowiedzi
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Usunięcie jest trwałe. Jeśli inne powiązane odpowiedzi odwołują się do tej odpowiedzi poprzez previous_response_id, odpowiedni kontekst stanie się niedostępny.
W Pythonie
client.responses.delete("resp-abc123")
Przypadki użycia pamięci masowej
Chatbot z historią
Włącz store: true dla wszystkich żądań. Użytkownik może wznowić rozmowę nawet po zamknięciu przeglądarki, pod warunkiem że przechowujesz ostatni identyfikator response_id.
Analiza danych wrażliwych
Użyj store: false dla żądań zawierających dane osobowe lub poufne. Odpowiedź jest przetwarzana w pamięci i nie jest utrwalana.
Audyt i zgodność
Pobieraj przechowane odpowiedzi, aby budować dzienniki audytowe. Usuwaj je, gdy nie są już potrzebne, aby spełnić wymogi polityk retencji danych.
Okres retencji
Przechowane odpowiedzi są automatycznie usuwane po 30 dniach. Nie możesz przedłużyć tego okresu poprzez API. Jeśli potrzebujesz dłuższej historii, zapisuj odpowiedzi we własnej bazie danych.
Kluczowe wnioski
store: trueutrwaluje odpowiedź na 30 dni –store: falsenic nie zapisujeGET /v1/responses/{id}pobiera przechowaną odpowiedźDELETE /v1/responses/{id}trwale usuwa odpowiedź- Łańcuchowanie poprzez
previous_response_idwymaga, aby odpowiedź była przechowywana - Odpowiedzi są automatycznie czyszczone po 30 dniach
- Użyj
store: falsedla danych wrażliwych