Αποθήκευση και Μονιμότητα Απαντήσεων
Σε αυτήν τη σελίδα
Ελέγξτε τη διάρκεια ζωής των δεδομένων σας
Το API Απαντήσεων (Responses API) περιλαμβάνει ενσωματωμένη αποθήκευση: με την παράμετρο store: true, οι διακομιστές της xAI διατηρούν τις απαντήσεις σας για 30 ημέρες. Μπορείτε να τις ανακτήσετε, να τις προβάλετε και να τις διαγράψετε ανά πάσα στιγμή χρησιμοποιώντας εξειδικευμένα endpoints.
store: true έναντι store: false
Λειτουργία αποθήκευσης (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Η απάντηση παραμένει αποθηκευμένη για 30 ημέρες. Μπορείτε να:
- Την αναφέρετε χρησιμοποιώντας το
previous_response_idγια να συνεχίσετε τη συνομιλία - Την ανακτήσετε αργότερα με
GET /v1/responses/{id} - Την διαγράψετε με
DELETE /v1/responses/{id}
Ιδιωτική λειτουργία (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Η απάντηση δεν διατηρείται μετά το αίτημα. Λαμβάνετε το αποτέλεσμα στην απόκριση HTTP, αλλά καθίσταται μη προσβάσιμο στη συνέχεια. Η αλυσιδωτή σύνδεση μέσω previous_response_id δεν είναι δυνατή.
Χρησιμοποιήστε το store: false για ευαίσθητα δεδομένα ή όταν δεν χρειάζεται να συνεχίσετε τη συνομιλία.
Ανάκτηση μιας αποθηκευμένης απάντησης
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Το API επιστρέφει το πλήρες αντικείμενο απάντησης, ίδιο με αυτό που λάβατε κατά τη δημιουργία. Αυτό είναι χρήσιμο για:
- Έλεγχο (auditing) παρελθουσών αλληλεπιδράσεων
- Ανασυγκρότηση του ιστορικού μιας συνομιλίας
- Επαλήθευση του κόστους εκ των υστέρων
Σε Python
# Ανάκτηση μιας αποθηκευμένης απάντησης
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")
Διαγραφή μιας απάντησης
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Η διαγραφή είναι οριστική. Εάν άλλες αλυσιδωτές απαντήσεις αναφέρονται σε αυτή την απάντηση μέσω του previous_response_id, το αντίστοιχο πλαίσιο (context) δεν θα είναι πλέον διαθέσιμο.
Σε Python
client.responses.delete("resp-abc123")
Περιπτώσεις χρήσης αποθήκευσης
Chatbot με ιστορικό
Ενεργοποιήστε το store: true για όλα τα αιτήματα. Ο χρήστης μπορεί να επαναλάβει τη συνομιλία του ακόμα και μετά το κλείσιμο του προγράμματος περιήγησης, αρκεί να διατηρείτε το τελευταίο response_id.
Ανάλυση ευαίσθητων δεδομένων
Χρησιμοποιήστε store: false για αιτήματα που περιέχουν προσωπικά ή εμπιστευτικά δεδομένα. Η απάντηση επεξεργάζεται στη μνήμη και δεν αποθηκεύεται μόνιμα.
Έλεγχος και συμμόρφωση
Ανακτήστε αποθηκευμένες απαντήσεις για να δημιουργήσετε αρχεία ελέγχου (audit logs). Διαγράψτε τες όταν δεν χρειάζονται πλέον, ώστε να συμμορφώνεστε με τις πολιτικές διατήρησης δεδομένων.
Περίοδος διατήρησης
Οι αποθηκευμένες απαντήσεις διαγράφονται αυτόματα μετά από 30 ημέρες. Δεν μπορείτε να επεκτείνετε αυτή την περίοδο μέσω του API. Εάν χρειάζεστε μεγαλύτερο ιστορικό, αποθηκεύστε τις απαντήσεις στη δική σας βάση δεδομένων.
Βασικά σημεία
- Το
store: trueδιατηρεί την απάντηση για 30 ημέρες — τοstore: falseδεν διατηρεί τίποτα - Το
GET /v1/responses/{id}ανακτά μια αποθηκευμένη απάντηση - Το
DELETE /v1/responses/{id}διαγράφει οριστικά μια απάντηση - Η αλυσιδωτή σύνδεση μέσω
previous_response_idαπαιτεί η απάντηση να είναι αποθηκευμένη - Οι απαντήσεις διαγράφονται αυτόματα μετά από 30 ημέρες
- Χρησιμοποιήστε
store: falseγια ευαίσθητα δεδομένα