Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Käytä asetuksella store:false kuvia varten

Oppitunti 9 / 12 Päivitetty 30. heinäkuuta 2026 Aloittelija
Tällä sivulla
  1. Miksi kuvia ei kannata tallentaa
  2. Ongelmat kuvien tallentamisessa
  3. Tallennuksen poistaminen käytöstä
  4. Vaikutus keskusteluketjutukseen
  5. Paras käytäntö: Systemaattinen käärijäfunktio
  6. Keskeiset asiat

Miksi kuvia ei kannata tallentaa

xAI:n Responses API tarjoaa ominaisuuden pyyntöjen ja vastausten palvelinpuoleiseen tallentamiseen. Oletusarvoisesti käytössä oleva store: true säilyttää vuorovaikutuksesi 30 päivän ajan. Kun käsittelet kuitenkin kuvia, xAI:n dokumentaatio suosittelee nimenomaisesti tämän tallennuksen poistamista käytöstä.

Ongelmat kuvien tallentamisessa

Kun lähetät kuvia asetuksella store: true (oletuskäyttäytyminen), koko pyyntö – kuvadata mukaan lukien – tallennetaan xAI:n palvelimille. Tämä aiheuttaa kaksi suurta ongelmaa:

Pyyntöjen epäonnistumiset

xAI:n dokumentaatio varoittaa: kuvia sisältävät pyynnöt voivat epäonnistua, jos tallennus on käytössä. Tämä tapahtuu erityisesti silloin, kun:

  • Kuvat ovat suuria (lähellä 20 Mt:n rajaa)
  • Samassa pyynnössä lähetetään useita kuvia
  • Kuvat on koodattu Base64-muotoon (koodattu merkkijono on noin 33 % alkuperäistä tiedostoa suurempi)

GDPR ja tietosuoja

Jos kuvasi sisältävät henkilötietoja (passikuvia, arkaluonteisia asiakirjoja, kasvoja), niiden tallentaminen 30 päiväksi kolmannen osapuolen palvelimelle herättää kysymyksiä GDPR:n ja eurooppalaisten määräysten noudattamisesta.

Tallennuksen poistaminen käytöstä

Ratkaisu on yksinkertainen: lisää store: false jokaiseen kuvia sisältävään pyyntöön.

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  # Poista tallennus käytöstä
)

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

Chat Completions API on luonteeltaan tilaton, eikä se tallenna mitään palvelinpuolelle. Lisäasetuksia ei tarvita. Tämä on yksi tämän päätepisteen eduista arkaluonteisten kuvien käsittelyssä.

Vaikutus keskusteluketjutukseen

Asetuksella store: false menetat mahdollisuuden käyttää previous_response_id:tä pyyntöjen ketjuttamiseen. Jokainen pyyntö muuttuu itsenäiseksi.

Jos tarvitset keskustelukontekstin ylläpitoa kuvien ympärillä, kaksi lähestymistapaa on mahdollista:

Lähestymistapa 1: Kontekstin välittäminen manuaalisesti

# Ensimmäinen pyyntö
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
)

# Toinen pyyntö: sisällytä edellinen vastaus kontekstina
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
)

Lähestymistapa 2: Käytä Chat Completions -rajapintaa

Jos ketjutus on välttämätöntä, käytä Chat Completions API:a, joka hallitsee kontekstia messages-taulukon kautta tallentamatta mitään:

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
)

# Lisää vastaus ja seuraava kysymys
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
)

Paras käytäntö: Systemaattinen käärijäfunktio

Jotta et koskaan unohtaisi asetusta store: false kuvia käsitellessäsi, luo käärijäfunktio:

def vision_request(images, prompt, detail="auto"):
    """Vision-pyyntö automaattisella store:false-asetuksella."""
    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  # Aina poissa käytöstä kuvia varten
    )

Keskeiset asiat

  • Käytä aina asetusta store: false, kun lähetät kuvia Responses API:n kautta
  • Käytössä oleva tallennus voi aiheuttaa pyyntöjen epäonnistumisia kuvien kanssa
  • store: false suojaa myös visuaalisen datan yksityisyyttä
  • Ketjutus previous_response_id:n kautta ei ole käytettävissä asetuksella store: false
  • Chat Completions API on luonnostaan tilaton, eikä vaadi tätä asetusta