Úsáid store:false do Íomhánna
Ar an leathanach seo
Cén fáth nach ba chóir duit íomhánna a stóráil
Tairgeann API Freagarthaí xAI gné chun iarratais agus freagraí a stóráil ar an bhfreastalaí. Tá an ghné seo cumasaithe go huathoibríoch le store: true, agus coinníonn an mharthanacht seo do chuid idirghníomhaíochtaí ar feadh 30 lá. Mar sin féin, nuair a bhíonn tú ag obair le híomhánna, molann doiciméadú xAI go sonrach an stóráil seo a dhíchumasú.
An fhadhb a bhaineann le híomhánna a stóráil
Nuair a sheolann tú íomhánna le store: true (an iompraíocht réamhshocraithe), coinnítear an t-iarratas iomlán – lena n-áirítear sonraí na híomhá – ar fhreastalaithe xAI. Cruthaíonn sé seo dhá fhadhb mhóra:
Teipeanna ar Iarratais
Cuireann doiciméadú xAI in iúl go bhféadfadh iarratais ina bhfuil íomhánna teip má tá an stóráil cumasaithe. Tarlaíonn an iompraíocht seo go háirithe nuair a bhíonn:
- Íomhánna móra (gar don teorainn 20 MiB)
- Ilíomhánna á seoladh san iarratas céanna
- Íomhánna ionchódaithe i mBase64 (tá an teaghrán ionchódaithe ~33% níos mó ná an comhad bunaidh)
Breithnithe GDPR agus Príobháideachta
Má tá sonraí pearsanta in do chuid íomhánna (grianghraif aitheantais, doiciméid íogaire, aghaidheanna), ardaíonn an stóráil orthu ar feadh 30 lá ar fhreastalaí tríú páirtí ceisteanna comhlíontachta le GDPR agus le rialacháin Eorpacha.
Conas an stóráil a dhíchumasú
Tá an réiteach simplí: cuir store: false le gach iarratas ina bhfuil íomhánna.
API Freagarthaí (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 Freagarthaí (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 Comhlánuithe Comhrá
Tá API Comhlánuithe Comhrá gan stát de réir nádúir agus ní stórálann sé aon rud ar an bhfreastalaí. Níl aon chumraíocht bhreise ag teastáil. Is ceann de bhuntáistí an chríochphointe seo é chun íomhánna íogaire a phróiseáil.
Tionchar ar Shlabhrú Comhráite
Le store: false, cailleann tú an cumas previous_response_id a úsáid chun iarratais a shlabhrú. Éiríonn gach iarratas neamhspleách.
Má tá ort comhthéacs comhráite a choinneáil timpeall ar íomhánna, tá dhá chur chuige indéanta:
Cur Chuige 1: Comhthéacs a Rith de Láimh
# 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
)
Cur Chuige 2: Úsáid a Bhaint as Comhlánuithe Comhrá
Má tá slabhrú ríthábhachtach, úsáid API Comhlánuithe Comhrá, a láimhseálann an comhthéacs tríd an eagar messages gan aon rud a stóráil:
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
)
Dea-Chleachtas: Clúdach Córasach
Chun store: false a dhéanamh dearmad riamh agus tú ag obair le híomhánna, cruthaigh clúdach (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
)
Príomhphointí
- Úsáid
store: falsei gcónaí nuair a sheolann tú íomhánna trí API Freagarthaí - Is féidir le stóráil chumasaithe teipeanna ar iarratais a chruthú le híomhánna
- Cosnaíonn
store: falsepríobháideacht na sonraí amhairc freisin - Níl slabhrú trí
previous_response_idar fáil lestore: false - Tá API Comhlánuithe Comhrá gan stát go nádúrtha agus ní éilíonn sé an rogha seo