Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kasuta piltide puhul store:false

Õppetund 9 / 12 Värskendatud 30. juuli 2026 Algajatele
Sellel lehel
  1. Miks ei tohiks pilte salvestada
  2. Probleemid piltide salvestamisega
  3. Kuidas salvestamine keelata
  4. Mõju vestluse aheldamisele
  5. Parim tava: süstemaatiline mähisfunktsioon
  6. Peamised punktid

Miks ei tohiks pilte salvestada

xAI Responses API pakub funktsiooni päringute ja vastuste serveripoolseks salvestamiseks. Vaikimisi on see lubatud väärtusega store: true, mis hoiab sinu suhtlust 30 päeva. Kui töötad aga piltidega, soovitab xAI dokumentatsioon selle salvestamise sõnaselgelt keelata.

Probleemid piltide salvestamisega

Kui saadad pilte koos seadistusega store: true (vaikimisi käitumine), salvestatakse kogu päring – koos pildiandmetega – xAI serveritesse. See tekitab kaks tõsist probleemi:

Päringute tõrked

xAI dokumentatsioon hoiatab: päringud, mis sisaldavad pilte, võivad salvestamise lubamisel tõrked tekitada. See juhtub eriti siis, kui:

  • Pildid on suured (lähedal 20 MiB piirile)
  • Samas päringus saadetakse mitu pilti
  • Pildid on Base64-kodeeritud (kodeeritud string on algsest failist umbes 33% suurem)

GDPR ja privaatsuskaalutlused

Kui sinu pildid sisaldavad isikuandmeid (isikutunnistuse fotod, tundlikud dokumendid, näod), tekib nende 30-päevane säilitamine kolmanda osapoole serveris küsimusi vastavusest GDPR-i ja Euroopa määrustega.

Kuidas salvestamine keelata

Lahendus on lihtne: lisa iga pilti sisaldava päringu juurde 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": "Kirjelda seda pilti."}
    ],
    store=False  # Keela salvestamine
)

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": "Kirjelda seda pilti."}
    ]
  }'

Chat Completions API

Chat Completions API on oma olemuselt olekuta (stateless) ega salvesta midagi serveripoolselt. Täiendavat seadistust pole vaja. See on üks selle lõpp-punkti eeliseid tundlike piltide töötlemisel.

Mõju vestluse aheldamisele

Seadistusega store: false kaotad võimaluse kasutada päringute aheldamiseks previous_response_id. Iga päring muutub iseseisvaks.

Kui sul on vaja säilitada piltide ümber vestluskonteksti, on võimalikud kaks lähenemist:

Lähenemine 1: Konteksti manuuaalne edastamine

# Esimene päring
response1 = client.responses.create(
    model="grok-4.5",
    input=[
        {"type": "input_image", "image_url": url_image},
        {"type": "input_text", "text": "Kirjelda seda pilti."}
    ],
    store=False
)

# Teine päring: lisa eelmine vastus kontekstina
response2 = client.responses.create(
    model="grok-4.5",
    input=[
        {"type": "input_text", "text": f"Eelnev kontekst: {response1.output_text}"},
        {"type": "input_image", "image_url": url_image},
        {"type": "input_text", "text": "Nüüd tuvasta domineerivad värvid."}
    ],
    store=False
)

Lähenemine 2: Kasuta Chat Completions API-t

Kui aheldamine on hädavajalik, kasuta Chat Completions API-t, mis haldab konteksti massiivi messages kaudu, salvestamata midagi:

messages = [
    {
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": url_image}},
            {"type": "text", "text": "Kirjelda seda pilti."}
        ]
    }
]

response1 = client.chat.completions.create(
    model="grok-4.5",
    messages=messages
)

# Lisa vastus ja järgmine küsimus
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Tuvasta domineerivad värvid."})

response2 = client.chat.completions.create(
    model="grok-4.5",
    messages=messages
)

Parim tava: süstemaatiline mähisfunktsioon

Et piltidega töötades mitte kunagi unustada store: false lisada, loo mähisfunktsioon:

def vision_request(images, prompt, detail="auto"):
    """Visioonipäring automaatse store:false-ga."""
    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  # Piltide puhul alati keelatud
    )

Peamised punktid

  • Kasuta Responses API kaudu pilte saates alati väärtust store: false
  • Lubatud salvestamine võib piltidega töötamisel põhjustada päringute tõrkeid
  • store: false kaitseb ka visuaalsete andmete privaatsust
  • Aheldamine previous_response_id kaudu ei ole store: false korral võimalik
  • Chat Completions API on loomulikult olekuta ja ei vaja seda valikut