Salt la conținutul principal
Română— Alege o limbă
Meniu

Utilizați store:false pentru imagini

Lecția 9 din 12 Actualizată 30 iulie 2026 Începător
Pe această pagină
  1. De ce nu ar trebui să stocați imaginile
  2. Problema stocării imaginilor
  3. Cum să dezactivați stocarea
  4. Impactul asupra înlănțuirii conversațiilor
  5. Bună practică: Wrapper sistematic
  6. Puncte cheie

De ce nu ar trebui să stocați imaginile

API-ul Responses de la xAI oferă o funcție pentru stocarea lato-server a cererilor și răspunsurilor. Activată implicit cu store: true, această persistență păstrează interacțiunile dumneavoastră timp de 30 de zile. Totuși, atunci când lucrați cu imagini, documentația xAI recomandă în mod explicit dezactivarea acestei stocări.

Problema stocării imaginilor

Atunci când trimiteți imagini cu store: true (comportamentul implicit), cererea completă – inclusiv datele imaginii – este reținută pe serverele xAI. Acest lucru creează două probleme majore:

Eșecuri ale cererilor

Documentația xAI avertizează: cererile care conțin imagini pot eșua dacă stocarea este activată. Acest comportament apare în special când:

  • Imaginile sunt mari (aproape de limita de 20 MiB)
  • Se trimit mai multe imagini în aceeași cerere
  • Imaginile sunt codificate Base64 (șirul codificat este cu ~33% mai mare decât fișierul original)

Considerații GDPR și de confidențialitate

Dacă imaginile dumneavoastră conțin date cu caracter personal (fotografii de buletin, documente sensibile, fețe), stocarea lor timp de 30 de zile pe un server terț ridică probleme de conformitate cu GDPR și reglementările europene.

Cum să dezactivați stocarea

Soluția este simplă: adăugați store: false la fiecare cerere care conține imagini.

API-ul Responses (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  # Disable storage
)

API-ul Responses (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."}
    ]
  }'

API-ul Chat Completions

API-ul Chat Completions este prin natura sa fără stare (stateless) și nu stochează nimic lato-server. Nu este necesară nicio configurare suplimentară. Acesta este unul dintre avantajele acestui endpoint pentru procesarea imaginilor sensibile.

Impactul asupra înlănțuirii conversațiilor

Cu store: false, pierdeți capacitatea de a utiliza previous_response_id pentru a înlănțui cererile. Fiecare cerere devine independentă.

Dacă trebuie să mențineți contextul conversațional în jurul imaginilor, sunt posibile două abordări:

Abordarea 1: Transmiterea manuală a contextului

# First request
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
)

# Second request: include previous response as context
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
)

Abordarea 2: Utilizarea Chat Completions

Dacă înlănțuirea este esențială, utilizați API-ul Chat Completions, care gestionează contextul prin tabloul messages fără a stoca nimic:

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
)

# Add the response and the next question
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
)

Bună practică: Wrapper sistematic

Pentru a nu uita niciodată store: false atunci când lucrați cu imagini, creați un wrapper:

def vision_request(images, prompt, detail="auto"):
    """Vision request with automatic 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  # Always disabled for images
    )

Puncte cheie

  • Utilizați întotdeauna store: false atunci când trimiteți imagini prin API-ul Responses
  • Stocarea activată poate provoca eșecuri ale cererilor cu imagini
  • store: false protejează, de asemenea, confidențialitatea datelor vizuale
  • Înlănțuirea prin previous_response_id nu este disponibilă cu store: false
  • API-ul Chat Completions este în mod natural fără stare și nu necesită această opțiune