Použij store:false pro obrázky
Na této stránce
Proč bys neměl ukládat obrázky
API Responses od xAI nabízí funkci pro ukládání požadavků a odpovědí na straně serveru. Ve výchozím nastavení je povoleno pomocí store: true a toto přetrvávání uchovává tvé interakce po dobu 30 dnů. Když však pracuješ s obrázky, dokumentace xAI výslovně doporučuje toto ukládání vypnout.
Problém s ukládáním obrázků
Když odešleš obrázky s store: true (výchozí chování), celý požadavek – včetně dat obrázku – zůstane uložen na serverech xAI. To vytváří dva hlavní problémy:
Selhání požadavků
Dokumentace xAI varuje: požadavky obsahující obrázky mohou při povoleném ukládání selhat. K tomuto chování dochází zejména tehdy, když:
- Jsou obrázky velké (blízko limitu 20 MiB)
- Je ve stejném požadavku odesláno více obrázků
- Jsou obrázky kódovány v Base64 (kódovaný řetězec je přibližně o 33 % větší než původní soubor)
GDPR a aspekty ochrany soukromí
Pokud tvé obrázky obsahují osobní údaje (fotografie na doklady, citlivé dokumenty, obličeje), jejich ukládání po dobu 30 dnů na serveru třetí strany vyvolává otázky týkající se souladu s nařízením GDPR a evropskými předpisy.
Jak vypnout ukládání
Řešení je jednoduché: ke každému požadavku obsahujícímu obrázky přidej store: false.
Responses API (Python)
response = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Popiš tento obrázek."}
],
store=False # Vypnout ukládání
)
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": "Popiš tento obrázek."}
]
}'
Chat Completions API
API Chat Completions je ze své podstaty bezstavové a nic neukládá na straně serveru. Není potřeba žádná další konfigurace. To je jedna z výhod tohoto koncového bodu pro zpracování citlivých obrázků.
Dopad na řetězení konverzací
Při použití store: false ztrácíš možnost používat previous_response_id k řetězení požadavků. Každý požadavek se stává nezávislým.
Pokud potřebuješ udržet kontext konverzace kolem obrázků, jsou možné dva přístupy:
Přístup 1: Ruční předání kontextu
# První požadavek
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Popiš tento obrázek."}
],
store=False
)
# Druhý požadavek: zahrnutí předchozí odpovědi jako kontextu
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Předchozí kontext: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Nyní identifikuj dominantní barvy."}
],
store=False
)
Přístup 2: Použití Chat Completions
Pokud je řetězení nezbytné, použij API Chat Completions, které zpracovává kontext prostřednictvím pole messages bez jakéhokoli ukládání:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Popiš tento obrázek."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Přidání odpovědi a další otázky
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Identifikuj dominantní barvy."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Osvědčený postup: Systematický wrapper
Abys nikdy nezapomněl na store: false při práci s obrázky, vytvoř si wrapper funkci:
def vision_request(images, prompt, detail="auto"):
"""Požadavek na analýzu obrazu s automatickým 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 # Pro obrázky vždy vypnuto
)
Klíčové poznatky
- Při odesílání obrázků přes Responses API vždy používej
store: false - Povolené ukládání může u obrázků způsobit selhání požadavků
store: falsetaké chrání soukromí vizuálních dat- Řetězení prostřednictvím
previous_response_idnení sstore: falsedostupné - API Chat Completions je přirozeně bezstavové a tuto možnost nevyžaduje