Utilizați store:false pentru imagini
Pe această pagină
De ce nu ar trebui să stocați imaginile
API-ul Responses de la xAI oferă o funcție pentru stocarea lato-server a cererilor și răspunsurilor. Activată implicit cu store: true, această persistență păstrează interacțiunile dumneavoastră timp de 30 de zile. Totuși, atunci când lucrați cu imagini, documentația xAI recomandă în mod explicit dezactivarea acestei stocări.
Problema stocării imaginilor
Atunci când trimiteți imagini cu store: true (comportamentul implicit), cererea completă – inclusiv datele imaginii – este reținută pe serverele xAI. Acest lucru creează două probleme majore:
Eșecuri ale cererilor
Documentația xAI avertizează: cererile care conțin imagini pot eșua dacă stocarea este activată. Acest comportament apare în special când:
- Imaginile sunt mari (aproape de limita de 20 MiB)
- Se trimit mai multe imagini în aceeași cerere
- Imaginile sunt codificate Base64 (șirul codificat este cu ~33% mai mare decât fișierul original)
Considerații GDPR și de confidențialitate
Dacă imaginile dumneavoastră conțin date cu caracter personal (fotografii de buletin, documente sensibile, fețe), stocarea lor timp de 30 de zile pe un server terț ridică probleme de conformitate cu GDPR și reglementările europene.
Cum să dezactivați stocarea
Soluția este simplă: adăugați store: false la fiecare cerere care conține imagini.
API-ul Responses (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
)
API-ul Responses (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."}
]
}'
API-ul Chat Completions
API-ul Chat Completions este prin natura sa fără stare (stateless) și nu stochează nimic lato-server. Nu este necesară nicio configurare suplimentară. Acesta este unul dintre avantajele acestui endpoint pentru procesarea imaginilor sensibile.
Impactul asupra înlănțuirii conversațiilor
Cu store: false, pierdeți capacitatea de a utiliza previous_response_id pentru a înlănțui cererile. Fiecare cerere devine independentă.
Dacă trebuie să mențineți contextul conversațional în jurul imaginilor, sunt posibile două abordări:
Abordarea 1: Transmiterea manuală a contextului
# 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
)
Abordarea 2: Utilizarea Chat Completions
Dacă înlănțuirea este esențială, utilizați API-ul Chat Completions, care gestionează contextul prin tabloul messages fără a stoca nimic:
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
)
Bună practică: Wrapper sistematic
Pentru a nu uita niciodată store: false atunci când lucrați cu imagini, creați un 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
)
Puncte cheie
- Utilizați întotdeauna
store: falseatunci când trimiteți imagini prin API-ul Responses - Stocarea activată poate provoca eșecuri ale cererilor cu imagini
store: falseprotejează, de asemenea, confidențialitatea datelor vizuale- Înlănțuirea prin
previous_response_idnu este disponibilă custore: false - API-ul Chat Completions este în mod natural fără stare și nu necesită această opțiune