Uża store:false għall-Immaġnijiet
F'din il-paġna
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: falsemeta tibgħat immaġnijiet permezz tal-API tar-Risposti - Il-ħażna attivata tista’ tikkawża fallimenti fit-talbiet bl-immaġnijiet
store: falsejipproteġi wkoll il-privatezza tad-data viżiva- Il-katina permezz ta’
previous_response_idmhix 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