Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Použij store:false pro obrázky

Lekce 9 z 12 Aktualizováno 30. července 2026 Začátečník
Na této stránce
  1. Proč bys neměl ukládat obrázky
  2. Problém s ukládáním obrázků
  3. Jak vypnout ukládání
  4. Dopad na řetězení konverzací
  5. Osvědčený postup: Systematický wrapper
  6. Klíčové poznatky

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: false také chrání soukromí vizuálních dat
  • Řetězení prostřednictvím previous_response_id není s store: false dostupné
  • API Chat Completions je přirozeně bezstavové a tuto možnost nevyžaduje