Bilder mit store:false senden
Auf dieser Seite
Warum Sie Bilder nicht speichern sollten
Die Responses API von xAI bietet eine Funktion zur serverseitigen Speicherung von Anfragen und Antworten. Diese Persistenz ist standardmäßig mit store: true aktiviert und behält Ihre Interaktionen für 30 Tage. Bei der Arbeit mit Bildern empfiehlt die xAI-Dokumentation jedoch ausdrücklich, diese Speicherung zu deaktivieren.
Das Problem bei der Speicherung von Bildern
Wenn Sie Bilder mit store: true (das Standardverhalten) senden, wird die vollständige Anfrage – einschließlich der Bilddaten – auf den xAI-Servern gespeichert. Dies führt zu zwei wesentlichen Problemen:
Anfragefehler
Die xAI-Dokumentation warnt davor, dass Anfragen, die Bilder enthalten, fehlgeschlagen sein können, wenn die Speicherung aktiviert ist. Dieses Verhalten tritt insbesondere auf, wenn:
- Bilder groß sind (nahe der 20 MiB-Grenze)
- Mehrere Bilder in derselben Anfrage gesendet werden
- Bilder in Base64 kodiert sind (die kodierte Zeichenfolge ist ca. 33 % größer als die Originaldatei)
Datenschutz und DSGVO
Wenn Ihre Bilder personenbezogene Daten enthalten (Ausweisdokumente, sensible Unterlagen, Gesichter), wirft die Speicherung dieser Daten für 30 Tage auf einem Server eines Dritten Fragen zur Compliance mit der DSGVO und europäischen Vorschriften auf.
Speicher deaktivieren
Die Lösung ist einfach: Fügen Sie store: false zu jeder Anfrage hinzu, die Bilder enthält.
Responses API (Python)
response = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Beschreiben Sie dieses Bild."}
],
store=False # Speicherung deaktivieren
)
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": "Beschreiben Sie dieses Bild."}
]
}'
Chat Completions API
Die Chat Completions API ist von Natur aus zustandslos und speichert nichts serverseitig. Es ist keine zusätzliche Konfiguration erforderlich. Dies ist einer der Vorteile dieses Endpunkts für die Verarbeitung sensibler Bilder.
Auswirkungen auf die Verknüpfung von Gesprächen
Mit store: false verlieren Sie die Möglichkeit, previous_response_id zu verwenden, um Anfragen zu verknüpfen. Jede Anfrage wird unabhängig.
Wenn Sie den Gesprächskontext um Bilder herum aufrechterhalten müssen, sind zwei Ansätze möglich:
Ansatz 1: Kontext manuell übergeben
# Erste Anfrage
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Beschreiben Sie dieses Bild."}
],
store=False
)
# Zweite Anfrage: vorherige Antwort als Kontext einbeziehen
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Vorheriger Kontext: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Nun, identifizieren Sie die dominierenden Farben."}
],
store=False
)
Ansatz 2: Chat Completions verwenden
Wenn die Verknüpfung unerlässlich ist, verwenden Sie die Chat Completions API, die den Kontext über das messages-Array verwaltet, ohne etwas zu speichern:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Beschreiben Sie dieses Bild."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Antwort hinzufügen und nächste Frage
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Identifizieren Sie die dominierenden Farben."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Best Practice: Systematischer Wrapper
Um store: false nie zu vergessen, wenn Sie mit Bildern arbeiten, erstellen Sie einen Wrapper:
def vision_request(images, prompt, detail="auto"):
"""Vision-Anfrage mit automatischer 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 # Immer für Bilder deaktiviert
)
Kernaussagen
- Verwenden Sie immer
store: false, wenn Sie Bilder über die Responses API senden. - Aktiviert Speicherung kann Anfragefehler mit Bildern verursachen.
store: falseschützt auch die Privatsphäre visueller Daten.- Die Verknüpfung über
previous_response_idist mitstore: falsenicht verfügbar. - Die Chat Completions API ist von Natur aus zustandslos und benötigt diese Option nicht.