Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Úsáid store:false do Íomhánna

Ceacht 9 as 12 Nuashonraithe 30 Iúil 2026 Doicnéir
Ar an leathanach seo
  1. Cén fáth nach ba chóir duit íomhánna a stóráil
  2. An fhadhb a bhaineann le híomhánna a stóráil
  3. Conas an stóráil a dhíchumasú
  4. Tionchar ar Shlabhrú Comhráite
  5. Dea-Chleachtas: Clúdach Córasach
  6. Príomhphointí

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: false i 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: false príobháideacht na sonraí amhairc freisin
  • Níl slabhrú trí previous_response_id ar fáil le store: false
  • Tá API Comhlánuithe Comhrá gan stát go nádúrtha agus ní éilíonn sé an rogha seo