Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Naudokite store:false vaizdams

Paskaita 9 iš 12 Atnaujinta 2026 m. liepos 30 d. Pradedantisiems
Šiame puslapyje
  1. Kodėl neturėtumėte saugoti vaizdų
  2. Problemos, kylančios saugant vaizdus
  3. Kaip išjungti saugojimą
  4. Poveikis pokalbių grandinėms
  5. Geriausia praktika: Sisteminis apvalkalas (Wrapper)
  6. Svarbiausi punktai

Kodėl neturėtumėte saugoti vaizdų

xAI „Responses“ API siūlo funkciją, leidžiančią serverio pusėje saugoti užklausas ir atsakymus. Pagal numatytuosius nustatymus ši funkcija įjungta (store: true) ir jūsų sąveikos duomenys saugomi 30 dienų. Tačiau dirbant su vaizdais, xAI dokumentacijoje aiškiai rekomenduojama šį saugojimą išjungti.

Problemos, kylančios saugant vaizdus

Kai siunčiate vaizdus su store: true (numatytasis elgesys), visas užklausos turinys, įskaitant vaizdų duomenis, yra išsaugomas xAI serveriuose. Tai kelia dvi pagrindines problemas:

Užklausų nesėkmės

xAI dokumentacija įspėja: užklausos, kuriose yra vaizdų, gali nepavykti, jei saugojimas yra įjungtas. Toks elgesys ypač tikėtinas, kai:

  • Vaizdai yra dideli (artimi 20 MiB ribai)
  • Toje pačioje užklausoje siunčiami keli vaizdai
  • Vaizdai yra koduoti „Base64“ formatu (užkoduota eilutė yra maždaug 33 % didesnė už originalų failą)

GDPR ir privatumo aspektai

Jei jūsų vaizduose yra asmens duomenų (nuotraukos iš dokumentų, konfidencialūs dokumentai, veidai), jų saugojimas 30 dienų trečiosios šalies serveryje kelia atitikties GDPR ir Europos reglamentams klausimų.

Kaip išjungti saugojimą

Sprendimas paprastas: prie kiekvienos užklausos, kurioje yra vaizdų, pridėkite 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": "Describe this image."}
    ],
    store=False  # Išjungti saugojimą
)

„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 pagal savo pobūdį yra be būsenos (stateless) ir nieko nesaugo serverio pusėje. Jokių papildomų konfigūracijų nereikia. Tai vienas iš šio galinio taško privalumų apdorojant jautrius vaizdus.

Poveikis pokalbių grandinėms

Nustačius store: false, prarandate galimybę naudoti previous_response_id užklausoms grandinėti. Kiekviena užklausa tampa nepriklausoma.

Jei jums reikia išlaikyti pokalbio kontekstą dirbant su vaizdais, galima taikyti du būdus:

1 būdas: Rankinis konteksto perdavimas

# Pirmoji užklausa
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
)

# Antroji užklausa: įtraukti ankstesnį atsakymą kaip kontekstą
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 būdas: Naudoti „Chat Completions“

Jei grandinimas yra būtinas, naudokite „Chat Completions“ API, kuris tvarko kontekstą per messages masyvą nieko nesaugodamas:

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
)

# Pridėti atsakymą ir kitą klausimą
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
)

Geriausia praktika: Sisteminis apvalkalas (Wrapper)

Kad niekada nepamirštumėte nustatyti store: false dirbdami su vaizdais, sukurkite apvalkalą:

def vision_request(images, prompt, detail="auto"):
    """Vaizdo užklausa su automatiniu 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  # Vaizdams visada išjungta
    )

Svarbiausi punktai

  • Siųsdami vaizdus per „Responses“ API visada naudokite store: false
  • Įjungtas saugojimas gali sukelti užklausų nesėkmes dirbant su vaizdais
  • store: false taip pat apsaugo vaizdinių duomenų privatumą
  • Grandinimas naudojant previous_response_id nėra galimas nustatžius store: false
  • „Chat Completions“ API yra natūraliai be būsenos ir šios parinkties nereikalauja