Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Uża store:false għall-Immaġnijiet

Lezzjoni 9 / 12 Aġġornat 30 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Għaliex M’għandekx Taħżen l-Immaġnijiet
  2. Il-Problema bil-Ħażna tal-Immaġnijiet
  3. Kif Tiddiżattiva l-Ħażna
  4. Impatt fuq il-Katina tal-Konversazzjoni
  5. L-Aħjar Prattika: Wrapper Sistematiku
  6. Punti Ewlenin

Għaliex M’għandekx Taħżen l-Immaġnijiet

l-API tar-Risposti (Responses API) ta’ xAI toffri funzjoni għall-ħażna fuq is-server tat-talbiet u r-risposti. Attivata b’mod predefinit b’store: true, din il-persistenza żżomm l-interazzjonijiet tiegħek għal 30 jum. Madankollu, meta taħdem ma’ immaġnijiet, id-dokumentazzjoni ta’ xAI tirrakkomanda b’mod espliċitu li tiddiżattiva din il-ħażna.

Il-Problema bil-Ħażna tal-Immaġnijiet

Meta tibgħat immaġnijiet b’store: true (l-imġiba predefinita), it-talba sħiħa—inkluż id-data tal-immaġni—tinżamm fuq is-servers ta’ xAI. Dan joħloq żewġ problemi ewlenin:

Fallimenti fit-Talbiet

Id-dokumentazzjoni ta’ xAI twissi: it-talbiet li fihom immaġnijiet jistgħu jfallu jekk il-ħażna tkun attivata. Din l-imġiba sseħħ b’mod partikolari meta:

  • L-immaġnijiet ikunu kbar (qrib il-limitu ta’ 20 MiB)
  • Jinbagħtu immaġnijiet multipli fl-istess talba
  • L-immaġnijiet ikunu kodifikati b’Base64 (l-istringa kodifikata tkun ~33% akbar mill-fajl oriġinali)

Il-GDPR u l-Kunsiderazzjonijiet dwar il-Privatezza

Jekk l-immaġnijiet tiegħek ikunu fihom data personali (ritratti tal-ID, dokumenti sensittivi, wiċċ), il-ħażna tagħhom għal 30 jum fuq server ta’ parti terza tqajjem mistoqsijiet dwar il-konformità mal-GDPR u r-regolamenti Ewropej.

Kif Tiddiżattiva l-Ħażna

Is-soluzzjoni hija sempliċi: żid store: false ma’ kull talba li fiha immaġnijiet.

API tar-Risposti (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 tar-Risposti (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 tal-Kompletamenti taċ-Chat (Chat Completions API)

L-API tal-Kompletamenti taċ-Chat hija mingħajr stat (stateless) b’mod naturali u ma taħżen xejn fuq is-server. M’hemmx bżonn ta’ konfigurazzjoni addizzjonali. Dan huwa wieħed mill-vantaġġi ta’ dan il-punt finali (endpoint) għall-ipproċessar ta’ immaġnijiet sensittivi.

Impatt fuq il-Katina tal-Konversazzjoni

B’store: false, titlef il-kapaċità li tuża previous_response_id biex tgħaqqad it-talbiet. Kull talba ssir indipendenti.

Jekk għandek bżonn iżżomm il-kuntest konversazzjonali madwar l-immaġnijiet, hemm żewġ approċċi possibbli:

Approċċ 1: Għaddi l-Kuntest Manwalment

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

Approċċ 2: Uża l-Kompletamenti taċ-Chat

Jekk il-katina (chaining) hija essenzjali, uża l-API tal-Kompletamenti taċ-Chat, li timmaniġġja l-kuntest permezz tal-array messages mingħajr ma taħżen xejn:

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
)

L-Aħjar Prattika: Wrapper Sistematiku

Biex qatt ma tinsa store: false meta taħdem ma’ immaġnijiet, oħloq 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
    )

Punti Ewlenin

  • Uża dejjem store: false meta tibgħat immaġnijiet permezz tal-API tar-Risposti
  • Il-ħażna attivata tista’ tikkawża fallimenti fit-talbiet bl-immaġnijiet
  • store: false jipproteġi wkoll il-privatezza tad-data viżiva
  • Il-katina permezz ta’ previous_response_id mhix disponibbli b’store: false
  • L-API tal-Kompletamenti taċ-Chat hija mingħajr stat b’mod naturali u ma teħtieġx din l-għażla