Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Utilizar store:false para Imagens

Aula 9 de 12 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Por Que Não Deve Armazenar Imagens
  2. O Problema de Armazenar Imagens
  3. Como Desativar o Armazenamento
  4. Impacto no Encadeamento de Conversas
  5. Boa Prática: Wrapper Sistemático
  6. Pontos-chave

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: false ao enviar imagens através da API de Respostas
  • O armazenamento ativado pode causar falhas nos pedidos com imagens
  • store: false também protege a privacidade dos dados visuais
  • O encadeamento via previous_response_id não está disponível com store: false
  • A API de Completamentos de Chat é naturalmente sem estado e não requer esta opção