Usa store:false para imágenes
En esta página
Por qué no debes almacenar imágenes
La API de Responses de xAI ofrece una función para el almacenamiento en el servidor de solicitudes y respuestas. Activada por defecto con store: true, esta persistencia conserva tus interacciones durante 30 días. Sin embargo, cuando trabajas con imágenes, la documentación de xAI recomienda explícitamente desactivar este almacenamiento.
El problema de almacenar imágenes
Cuando envías imágenes con store: true (el comportamiento por defecto), la solicitud completa, incluidos los datos de la imagen, se retiene en los servidores de xAI. Esto genera dos problemas principales:
Fallos en las solicitudes
La documentación de xAI advierte: las solicitudes que contienen imágenes pueden fallar si el almacenamiento está activado. Este comportamiento ocurre especialmente cuando:
- Las imágenes son grandes (cerca del límite de 20 MiB)
- Se envían varias imágenes en la misma solicitud
- Las imágenes están codificadas en Base64 (la cadena codificada es aproximadamente un 33 % más grande que el archivo original)
Consideraciones sobre el RGPD y la privacidad
Si tus imágenes contienen datos personales (fotos de documentos de identidad, documentos sensibles, rostros), almacenarlas durante 30 días en un servidor de terceros plantea dudas de cumplimiento con el RGPD y la normativa europea.
Cómo desactivar el almacenamiento
La solución es sencilla: añade store: false a cada solicitud que contenga imágenes.
API de Responses (Python)
response = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe esta imagen."}
],
store=False # Desactivar almacenamiento
)
API de 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 esta imagen."}
]
}'
API de Chat Completions
La API de Chat Completions es stateless por naturaleza y no almacena nada en el servidor. No se necesita configuración adicional. Esta es una de las ventajas de este endpoint para procesar imágenes sensibles.
Impacto en el encadenamiento de conversaciones
Con store: false, pierdes la capacidad de usar previous_response_id para encadenar solicitudes. Cada solicitud se vuelve independiente.
Si necesitas mantener el contexto conversacional alrededor de imágenes, son posibles dos enfoques:
Enfoque 1: Pasar el contexto manualmente
# Primera solicitud
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe esta imagen."}
],
store=False
)
# Segunda solicitud: incluir la respuesta anterior como contexto
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Contexto anterior: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Ahora, identifica los colores dominantes."}
],
store=False
)
Enfoque 2: Usar Chat Completions
Si el encadenamiento es esencial, usa la API de Chat Completions, que gestiona el contexto mediante el array messages sin almacenar nada:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Describe esta imagen."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Añadir la respuesta y la siguiente pregunta
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Identifica los colores dominantes."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Buena práctica: envoltorio sistemático
Para no olvidar nunca store: false cuando trabajes con imágenes, crea un envoltorio:
def vision_request(images, prompt, detail="auto"):
"""Solicitud de visión con store:false automático."""
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 # Siempre desactivado para imágenes
)
Puntos clave
- Usa siempre
store: falsecuando envíes imágenes mediante la API de Responses - El almacenamiento activado puede provocar fallos en las solicitudes con imágenes
store: falsetambién protege la privacidad de los datos visuales- El encadenamiento mediante
previous_response_idno está disponible constore: false - La API de Chat Completions es naturalmente stateless y no requiere esta opción