Usa store:false per le immagini
In questa pagina
Perché non dovresti archiviare le immagini
Le API Responses di xAI offrono una funzionalità per l’archiviazione lato server delle richieste e delle risposte. Abilitata di default con store: true, questa persistenza conserva le tue interazioni per 30 giorni. Tuttavia, quando lavori con le immagini, la documentazione di xAI raccomanda esplicitamente di disabilitare questo archivio.
Il problema dell’archiviazione delle immagini
Quando invii immagini con store: true (il comportamento predefinito), l’intera richiesta, inclusi i dati dell’immagine, viene conservata sui server di xAI. Questo crea due problemi principali:
Fallimenti delle richieste
La documentazione di xAI avverte: le richieste contenenti immagini potrebbero fallire se l’archiviazione è abilitata. Questo comportamento si verifica particolarmente quando:
- Le immagini sono grandi (vicine al limite di 20 MiB)
- Vengono inviate più immagini nella stessa richiesta
- Le immagini sono codificate in Base64 (la stringa codificata è circa il 33% più grande del file originale)
Considerazioni su GDPR e privacy
Se le tue immagini contengono dati personali (foto di documenti d’identità, documenti sensibili, volti), conservarle per 30 giorni su un server di terze parti solleva questioni di conformità al GDPR e alle normative europee.
Come disabilitare l’archiviazione
La soluzione è semplice: aggiungi store: false a ogni richiesta contenente immagini.
API 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 # Disabilita l'archiviazione
)
API 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 Chat Completions
L’API Chat Completions è intrinsecamente stateless e non archivia nulla lato server. Non è necessaria alcuna configurazione aggiuntiva. Questo è uno dei vantaggi di questo endpoint per l’elaborazione di immagini sensibili.
Impatto sulla concatenazione delle conversazioni
Con store: false, perdi la possibilità di usare previous_response_id per concatenare le richieste. Ogni richiesta diventa indipendente.
Se hai bisogno di mantenere il contesto conversazionale attorno alle immagini, sono possibili due approcci:
Approccio 1: Passare manualmente il contesto
# Prima richiesta
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
)
# Seconda richiesta: includi la risposta precedente come contesto
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
)
Approccio 2: Usare Chat Completions
Se la concatenazione è essenziale, usa l’API Chat Completions, che gestisce il contesto tramite l’array messages senza archiviare nulla:
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
)
# Aggiungi la risposta e la prossima domanda
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
)
Best Practice: Wrapper sistematico
Per non dimenticare mai store: false quando lavori con le immagini, crea un wrapper:
def vision_request(images, prompt, detail="auto"):
"""Richiesta vision con store:false automatico."""
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 # Sempre disabilitato per le immagini
)
Punti chiave
- Usa sempre
store: falsequando invii immagini tramite l’API Responses - L’archiviazione abilitata può causare fallimenti delle richieste con le immagini
store: falseprotegge anche la privacy dei dati visivi- La concatenazione tramite
previous_response_idnon è disponibile constore: false - L’API Chat Completions è naturalmente stateless e non richiede questa opzione