Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Használd a store:false beállítást képeknél

9. lecke 12 közül Frissítve 2026. július 30. Kezdő
Ezen az oldalon
  1. Miért ne tárold a képeket?
  2. A képek tárolásának problémái
  3. Hogyan tiltsd le a tárolást?
  4. Hatás a beszélgetések láncolására
  5. Legjobb gyakorlat: Rendszeres burkolófüggvény
  6. Főbb megállapítások

Miért ne tárold a képeket?

Az xAI Responses API kínál egy funkciót a kérések és válaszok szerveroldali tárolására. Ez a funkció alapértelmezetten engedélyezve van (store: true), és 30 napig őrzi meg az interakcióidat. Amikor azonban képekkel dolgozol, az xAI dokumentációja kifejezetten javasolja ezen tárolás letiltását.

A képek tárolásának problémái

Amikor store: true beállítással (ami az alapértelmezett viselkedés) küldesz képeket, a teljes kérés – beleértve a képadatokat is – megmarad az xAI szerverein. Ez két fő problémát okoz:

Kérések meghiúsulása

Az xAI dokumentációja figyelmeztet: a képeket tartalmazó kérések meghiúsulhatnak, ha a tárolás engedélyezve van. Ez a viselkedés különösen akkor fordul elő, ha:

  • A képek nagy méretűek (közel vannak a 20 MiB-os limithez)
  • Több képet küldesz ugyanabban a kérésben
  • A képek Base64 kódolásúak (a kódolt karakterlánc körülbelül 33%-kal nagyobb, mint az eredeti fájl)

GDPR és adatvédelmi szempontok

Ha a képeid személyes adatokat tartalmaznak (igazolványképek, érzékeny dokumentumok, arcok), akkor azok 30 napos tárolása egy harmadik fél szerverén megfelelőségi kérdéseket vet fel a GDPR és az európai szabályozások tekintetében.

Hogyan tiltsd le a tárolást?

A megoldás egyszerű: adj hozzá egy store: false paramétert minden olyan kéréshez, amely képeket tartalmaz.

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  # Tárolás letiltása
)

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

A Chat Completions API természeténél fogva állapot nélküli (stateless), és semmit nem tárol szerveroldalon. Nincs szükség további konfigurációra. Ez az egyik előnye ennek a végpontnak az érzékeny képek feldolgozásakor.

Hatás a beszélgetések láncolására

A store: false beállítással elveszíted a lehetőséget, hogy a previous_response_id segítségével láncold a kéréseket. Minden kérés függetlenné válik.

Ha képek körében kell fenntartanod a beszélgetési kontextust, két megközelítés lehetséges:

1. megközelítés: Kontextus manuális továbbítása

# Első kérés
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
)

# Második kérés: az előző válasz belefoglalása kontextusként
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
)

2. megközelítés: Chat Completions használata

Ha a láncolás elengedhetetlen, használd a Chat Completions API-t, amely a messages tömbön keresztül kezeli a kontextust anélkül, hogy bármit is tárolna:

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
)

# A válasz és a következő kérdés hozzáadása
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
)

Legjobb gyakorlat: Rendszeres burkolófüggvény

Hogy sose felejtsd el a store: false beállítást képekkel való munka során, hozz létre egy burkolófüggvényt:

def vision_request(images, prompt, detail="auto"):
    """Vision kérés automatikus store:false beállítással."""
    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  # Képeknél mindig letiltva
    )

Főbb megállapítások

  • Mindig használd a store: false beállítást, amikor képeket küldesz a Responses API-n keresztül
  • Az engedélyezett tárolás kérések meghiúsulását okozhatja képek esetén
  • A store: false védi a vizuális adatok adatvédelmét is
  • A previous_response_id segítségével történő láncolás nem érhető el store: false esetén
  • A Chat Completions API természeténél fogva állapot nélküli, és nem igényli ezt a beállítást