Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Gebruik store:false voor afbeeldingen

Les 9 van 12 Bijgewerkt op 30 juli 2026 Beginner
Op deze pagina
  1. Waarom u afbeeldingen niet moet opslaan
  2. Het probleem met het opslaan van afbeeldingen
  3. Hoe u opslag uitschakelt
  4. Impact op het koppelen van conversaties
  5. Best practice: systematische wrapper
  6. Belangrijkste punten

Waarom u afbeeldingen niet moet opslaan

De Responses API van xAI biedt een functie voor server-side opslag van verzoeken en antwoorden. Deze persistentie, standaard ingeschakeld met store: true, bewaart uw interacties gedurende 30 dagen. Bij het werken met afbeeldingen raadt de documentatie van xAI echter expliciet aan om deze opslag uit te schakelen.

Het probleem met het opslaan van afbeeldingen

Wanneer u afbeeldingen verstuurt met store: true (het standaardgedrag), wordt het volledige verzoek – inclusief de afbeeldingsdata – bewaard op de servers van xAI. Dit leidt tot twee grote problemen:

Mislukte verzoeken

De documentatie van xAI waarschuwt: verzoeken die afbeeldingen bevatten, kunnen mislukken als opslag is ingeschakeld. Dit gedrag doet zich vooral voor wanneer:

  • Afbeeldingen groot zijn (dicht bij de limiet van 20 MiB)
  • Er meerdere afbeeldingen in hetzelfde verzoek worden verzonden
  • Afbeeldingen Base64-gecodeerd zijn (de gecodeerde string is ongeveer 33% groter dan het oorspronkelijke bestand)

GDPR en privacyoverwegingen

Als uw afbeeldingen persoonsgegevens bevatten (ID-foto’s, gevoelige documenten, gezichten), roept het 30 dagen lang opslaan ervan op een server van een derde partij vragen op over de naleving van de GDPR en Europese regelgeving.

Hoe u opslag uitschakelt

De oplossing is eenvoudig: voeg store: false toe aan elk verzoek dat afbeeldingen bevat.

Responses API (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  # Opslag uitschakelen
)

Responses API (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."}
    ]
  }'

Chat Completions API

De Chat Completions API is van nature stateless en slaat niets op de server op. Er is geen extra configuratie nodig. Dit is een van de voordelen van dit eindpunt voor het verwerken van gevoelige afbeeldingen.

Impact op het koppelen van conversaties

Met store: false verliest u de mogelijkheid om previous_response_id te gebruiken om verzoeken aan elkaar te koppelen. Elk verzoek wordt onafhankelijk.

Als u de context van een conversatie rondom afbeeldingen wilt behouden, zijn er twee benaderingen mogelijk:

Benadering 1: Context handmatig doorgeven

# Eerste verzoek
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
)

# Tweede verzoek: neem vorig antwoord op als 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
)

Benadering 2: Gebruik Chat Completions

Als het koppelen van verzoeken essentieel is, gebruik dan de Chat Completions API. Deze beheert de context via de messages-array zonder iets op te slaan:

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
)

# Voeg het antwoord en de volgende vraag toe
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: systematische wrapper

Om nooit te vergeten store: false te gebruiken bij het werken met afbeeldingen, maakt u best een wrapper-functie:

def vision_request(images, prompt, detail="auto"):
    """Vision request met automatische 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  # Altijd uitgeschakeld voor afbeeldingen
    )

Belangrijkste punten

  • Gebruik altijd store: false wanneer u afbeeldingen verstuurt via de Responses API
  • Ingeschakelde opslag kan verzoeken met afbeeldingen doen mislukken
  • store: false beschermt ook de privacy van visuele data
  • Koppelen via previous_response_id is niet beschikbaar met store: false
  • De Chat Completions API is van nature stateless en vereist deze optie niet