Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izmanto store:false attēliem

Nodarbība 9 no 12 Atjaunota 2026. gada 30. jūlijs Iesācējs
Šajā lapā
  1. Kāpēc nevajadzētu glabāt attēlus
  2. Problēmas, glabājot attēlus
  3. Kā atslēgt glabāšanu
  4. Ietekme uz sarunu ķēdēšanu
  5. Labākā prakse: Sistemātisks aptinējs
  6. Galvenās atziņas

Kāpēc nevajadzētu glabāt attēlus

xAI Responses API piedāvā funkciju pieprasījumu un atbilžu glabāšanai servera pusē. Pēc noklusējuma tā ir ieslēgta ar store: true, saglabājot tavu mijiedarbību 30 dienas. Tomēr, strādājot ar attēliem, xAI dokumentācija skaidri iesaka šo glabāšanu atslēgt.

Problēmas, glabājot attēlus

Kad nosūti attēlus ar store: true (kas ir noklusējuma uzvedība), viss pieprasījums, ieskaitot attēla datus, tiek saglabāts xAI serveros. Tas rada divas nopietnas problēmas:

Pieprasījumu kļūmes

xAI dokumentācija brīdina: pieprasījumi, kas satur attēlus, var neizdoties, ja glabāšana ir ieslēgta. Šī uzvedība rodas jo īpaši tad, ja:

  • Attēli ir lieli (tuvu 20 MiB limitam)
  • Vienā pieprasījumā tiek sūtīti vairāki attēli
  • Attēli ir kodēti Base64 formātā (kodētā virkne ir par ~33% lielāka nekā oriģinālais fails)

GDPR un privātuma apsvērumi

Ja tavi attēli satur personas datus (personu apliecinošu dokumentu fotoattēlus, sensitīvus dokumentus, sejas), to glabāšana 30 dienas trešās puses serverī rada atbilstības jautājumus saistībā ar GDPR un Eiropas regulējumu.

Kā atslēgt glabāšanu

Risinājums ir vienkāršs: katram pieprasījumam, kas satur attēlus, pievieno 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  # Atslēgt glabāšanu
)

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 pēc savas būtības ir bez stāvokļa (stateless) un neko neglabā servera pusē. Papildu konfigurācija nav nepieciešama. Šī ir viena no šī galapunkta priekšrocībām, apstrādājot sensitīvus attēlus.

Ietekme uz sarunu ķēdēšanu

Izmantojot store: false, tu zaudē iespēju izmantot previous_response_id, lai ķēdētu pieprasījumus. Katrs pieprasījums kļūst neatkarīgs.

Ja tev ir nepieciešams uzturēt sarunas kontekstu ap attēliem, ir iespējamas divas pieejas:

1. pieeja: Konteksta nodošana manuāli

# Pirmais pieprasījums
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
)

# Otrais pieprasījums: iekļauj iepriekšējo atbildi kā kontekstu
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. pieeja: Chat Completions izmantošana

Ja ķēdēšana ir būtiska, izmanto Chat Completions API, kas pārvalda kontekstu, izmantojot messages masīvu, neko neglabājot:

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
)

# Pievieno atbildi un nākamo jautājumu
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
)

Labākā prakse: Sistemātisks aptinējs

Lai nekad neaizmirstu store: false, strādājot ar attēliem, izveido aptinēju (wrapper):

def vision_request(images, prompt, detail="auto"):
    """Vīzijas pieprasījums ar automātisku 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  # Attēliem vienmēr atslēgts
    )

Galvenās atziņas

  • Vienmēr izmanto store: false, sūtot attēlus, izmantojot Responses API
  • Ieslēgta glabāšana var izraisīt pieprasījumu kļūmes, strādājot ar attēliem
  • store: false arī aizsargā vizuālo datu privātumu
  • Ķēdēšana, izmantojot previous_response_id, nav pieejama, lietojot store: false
  • Chat Completions API ir dabiski bez stāvokļa un neprasa šo opciju