Χρήση του store:false για Εικόνες
Σε αυτήν τη σελίδα
Γιατί δεν πρέπει να αποθηκεύετε εικόνες
Το Responses API της xAI προσφέρει μια λειτουργία για την αποθήκευση αιτημάτων και απαντήσεων στον διακομιστή. Όταν είναι ενεργοποιημένη από προεπιλογή με store: true, αυτή η επιμονή διατηρεί τις αλληλεπιδράσεις σας για 30 ημέρες. Ωστόσο, όταν εργάζεστε με εικόνες, η τεκμηρίωση της xAI συνιστά ρητά την απενεργοποίηση αυτής της αποθήκευσης.
Το πρόβλημα με την αποθήκευση εικόνων
Όταν στέλνετε εικόνες με store: true (η προεπιλεγμένη συμπεριφορά), το πλήρες αίτημα—συμπεριλαμβανομένων των δεδομένων της εικόνας—διατηρείται στους διακομιστές της xAI. Αυτό δημιουργεί δύο σημαντικά ζητήματα:
Αποτυχίες αιτημάτων
Η τεκμηρίωση της xAI προειδοποιεί: τα αιτήματα που περιέχουν εικόνες ενδέχεται να αποτύχουν εάν η αποθήκευση είναι ενεργοποιημένη. Αυτή η συμπεριφορά εμφανίζεται ιδιαίτερα όταν:
- Οι εικόνες είναι μεγάλες (κοντά στο όριο των 20 MiB)
- Στέλνονται πολλαπλές εικόνες στο ίδιο αίτημα
- Οι εικόνες είναι κωδικοποιημένες σε Base64 (το κωδικοποιημένο string είναι περίπου 33% μεγαλύτερο από το αρχικό αρχείο)
GDPR και ζητήματα απορρήτου
Εάν οι εικόνες σας περιέχουν προσωπικά δεδομένα (φωτογραφίες ταυτοτήτων, ευαίσθητα έγγραφα, πρόσωπα), η αποθήκευσή τους για 30 ημέρες σε διακομιστή τρίτου μέρους εγείρει ζητήματα συμμόρφωσης με τον GDPR και τους ευρωπαϊκούς κανονισμούς.
Πώς να απενεργοποιήσετε την αποθήκευση
Η λύση είναι απλή: προσθέστε store: false σε κάθε αίτημα που περιέχει εικόνες.
Responses API (Python)
response = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe this image."}
],
store=False # Disable storage
)
Responses API (cURL)
curl -X POST "https://api.x.ai/v1/responses" \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"store": false,
"input": [
{"type": "input_image", "image_url": "https://exemple.com/photo.jpg"},
{"type": "input_text", "text": "Describe this image."}
]
}'
Chat Completions API
Το Chat Completions API είναι εξ ορισμού χωρίς κατάσταση (stateless) και δεν αποθηκεύει τίποτα στον διακομιστή. Δεν απαιτείται πρόσθετη διαμόρφωση. Αυτό αποτελεί ένα από τα πλεονεκτήματα αυτού του endpoint για την επεξεργασία ευαίσθητων εικόνων.
Επίπτωση στην αλυσίδα συνομιλίας
Με store: false, χάνετε τη δυνατότητα χρήσης του previous_response_id για την αλυσιδωτή σύνδεση αιτημάτων. Κάθε αίτημα γίνεται ανεξάρτητο.
Εάν χρειάζεται να διατηρήσετε το συμφραζόμενο της συνομιλίας γύρω από εικόνες, υπάρχουν δύο προσεγγίσεις:
Προσέγγιση 1: Χειροκίνητη διέλευση συμφραζομένου
# First request
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe this image."}
],
store=False
)
# Second request: include previous response as context
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Previous context: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Now, identify the dominant colors."}
],
store=False
)
Προσέγγιση 2: Χρήση του Chat Completions
Εάν η αλυσιδωτή σύνδεση είναι απαραίτητη, χρησιμοποιήστε το Chat Completions API, το οποίο διαχειρίζεται το συμφραζόμενο μέσω του πίνακα messages χωρίς να αποθηκεύει τίποτα:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Describe this image."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Add the response and the next question
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Identify the dominant colors."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Βέλτιστη πρακτική: Συστηματικό Wrapper
Για να μην ξεχνάτε ποτέ το store: false όταν εργάζεστε με εικόνες, δημιουργήστε ένα wrapper:
def vision_request(images, prompt, detail="auto"):
"""Vision request with automatic store:false."""
input_data = []
for img in images:
input_data.append({
"type": "input_image",
"image_url": img,
"detail": detail
})
input_data.append({
"type": "input_text",
"text": prompt
})
return client.responses.create(
model="grok-4.5",
input=input_data,
store=False # Always disabled for images
)
Βασικά σημεία
- Χρησιμοποιείτε πάντα
store: falseόταν στέλνετε εικόνες μέσω του Responses API - Η ενεργοποιημένη αποθήκευση μπορεί να προκαλέσει αποτυχίες αιτημάτων με εικόνες
- Το
store: falseπροστατεύει επίσης το απόρρητο των οπτικών δεδομένων - Η αλυσιδωτή σύνδεση μέσω
previous_response_idδεν είναι διαθέσιμη μεstore: false - Το Chat Completions API είναι φυσικά χωρίς κατάσταση και δεν απαιτεί αυτή την επιλογή