Naudokite store:false vaizdams
Šiame puslapyje
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: falsetaip pat apsaugo vaizdinių duomenų privatumą- Grandinimas naudojant
previous_response_idnėra galimas nustatžiusstore: false - „Chat Completions“ API yra natūraliai be būsenos ir šios parinkties nereikalauja