Utilizar store:false para Imagens
Nesta página
Por Que Não Deve Armazenar Imagens
A API de Respostas da xAI oferece uma funcionalidade para o armazenamento no servidor de pedidos e respostas. Ativada por predefinição com store: true, esta persistência mantém as suas interações durante 30 dias. No entanto, ao trabalhar com imagens, a documentação da xAI recomenda explicitamente desativar este armazenamento.
O Problema de Armazenar Imagens
Quando envia imagens com store: true (o comportamento predefinido), o pedido completo — incluindo os dados da imagem — é retido nos servidores da xAI. Isto cria dois problemas principais:
Falhas nos Pedidos
A documentação da xAI alerta: os pedidos que contêm imagens podem falhar se o armazenamento estiver ativado. Este comportamento ocorre particularmente quando:
- As imagens são grandes (próximas do limite de 20 MiB)
- São enviadas múltiplas imagens no mesmo pedido
- As imagens estão codificadas em Base64 (a cadeia codificada é ~33% maior que o ficheiro original)
Considerações sobre o RGPD e Privacidade
Se as suas imagens contiverem dados pessoais (fotos de identificação, documentos sensíveis, rostos), o seu armazenamento durante 30 dias num servidor de terceiros levanta questões de conformidade com o RGPD e a regulamentação europeia.
Como Desativar o Armazenamento
A solução é simples: adicione store: false a cada pedido que contenha imagens.
API de Respostas (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 de Respostas (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 de Completamentos de Chat
A API de Completamentos de Chat é, por natureza, sem estado e não armazena nada no servidor. Não é necessária configuração adicional. Esta é uma das vantagens deste endpoint para processar imagens sensíveis.
Impacto no Encadeamento de Conversas
Com store: false, perde a capacidade de usar previous_response_id para encadear pedidos. Cada pedido torna-se independente.
Se precisar de manter o contexto conversacional em torno de imagens, são possíveis duas abordagens:
Abordagem 1: Passar o Contexto Manualmente
# 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
)
Abordagem 2: Utilizar Completamentos de Chat
Se o encadeamento for essencial, utilize a API de Completamentos de Chat, que gere o contexto através do array messages sem armazenar nada:
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
)
Boa Prática: Wrapper Sistemático
Para nunca esquecer o store: false ao trabalhar com imagens, crie um 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
)
Pontos-chave
- Utilize sempre
store: falseao enviar imagens através da API de Respostas - O armazenamento ativado pode causar falhas nos pedidos com imagens
store: falsetambém protege a privacidade dos dados visuais- O encadeamento via
previous_response_idnão está disponível comstore: false - A API de Completamentos de Chat é naturalmente sem estado e não requer esta opção