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

Cruthaigh baisc fholamh

Ceacht 4 as 12 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An chéad chéim: túsú
  2. An gla cruthaithe
  3. Cur chun feidhme i bPython
  4. Cur chun feidhme i JavaScript
  5. Teorainneacha ráta cruthaithe
  6. Dea-chleachtais
  7. Príomhphointí

Nuashonraithe an 2 Samhain, 2026 bunaithe ar dhoiciméadú xAI: tá lascaine 20% ar mhúnlaí téacs incháilithe (ní 50%), úsáideann na samplaí an REST API agus an SDK oifigiúil xai-sdk (client.batch.*; ní úsáideann Batch API xAI formáid OpenAI, mar sin ní bhaineann SDK OpenAI leis), agus tá tosaíocht ag an Responses API ar Chat Completions, críochphointe sinsearach ag xAI. Foinse: Batch API · Tagairt REST · Praghsáil Baisce.

An chéad chéim: túsú

Is é cruthú baisce an chéad ghníomh concreideach i do shruth oibre. Tionscnann gla POST /v1/batches coimeádán folamh a ghlacfaidh d’iarratais ina dhiaidh sin. Tá an céim seo beartaithe a bheith íosta: cruthaíonn sé an t-aitheantóir agus ullmhaíonn sé an bhaisc ar an taobh freastalaí.

1

POST /v1/batches

Cruthaíonn sé baisc ainmnithe agus filleann sé a batch_id.

2

Stóráil an batch_id

Sábháil an t-aitheantóir le haghaidh oibríochtaí ina dhiaidh sin.

3

Cuir na hiarratais leis

Tá an bhaisc réidh le hiarratais a ghlacadh tríd an API.

An gla cruthaithe

Níl ach réimse amháin riachtanach i gcorp an iarratais, name:

curl -X POST https://api.x.ai/v1/batches \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "customer_review_analysis"}'

Áirítear sa fhreagra an batch_id, dátaí an chruthaithe agus an éaga, agus comhairimh na baisce, atá fós ag nialas (sampla ón tagairt API):

{
  "batch_id": "batch_1934e8b5-f3dc-45f1-8329-9841b0aee9d8",
  "name": "customer_review_analysis",
  "create_time": "2025-11-11",
  "expire_time": "2025-11-12",
  "create_api_key_id": "********-****-****-****-************",
  "cancel_time": null,
  "cancel_by_xai_message": null,
  "state": {
    "num_requests": 0,
    "num_pending": 0,
    "num_success": 0,
    "num_error": 0,
    "num_cancelled": 0
  }
}

Cur chun feidhme i bPython

Suiteáiltear an SDK oifigiúil le pip install xai-sdk (leagan 1.21.0 ón 2 Samhain, 2026; Python 3.10 ar a laghad). Léann sé an eochair ón athróg timpeallachta XAI_API_KEY:

from xai_sdk import Client

client = Client()

batch = client.batch.create(batch_name="customer_review_analysis")
batch_id = batch.batch_id
print(f"Batch created: {batch_id}")

Is é an batch_id a fhilltear an t-aitheantóir uathúil do do bhaisc. Coinnigh i athróg, i gcomhad, nó i mbunachar sonraí é, ag brath ar do ailtireacht.

Cur chun feidhme i JavaScript

Gan SDK, is leor fetch simplí chuig an REST API:

const response = await fetch("https://api.x.ai/v1/batches", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.XAI_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ name: "customer_review_analysis" })
});

const batch = await response.json();
console.log(`Batch created: ${batch.batch_id}`);

Teorainneacha ráta cruthaithe

Tá cruthú baisce teoranta do 2 in aghaidh an tsoicind in aghaidh an fhoirne; níl teorainn ar líon na mbaisceanna féin. Go praiticiúil, is annamh a shroichfidh tú an teorainn seo: de ghnáth cruthaíonn tú baisc amháin in aghaidh na hoibríochta, agus ansin cuireann tú do chuid iarratas go léir leis. Má chruthaíonn tú roinnt i lúb, spásáil na glaonna 500 millisoicind ar a laghad óna chéile.

Dea-chleachtais

Tabhair ainm cuí do do bhaisceanna: tá an t-ainm riachtanach, mar sin déan é úsáideach. Is furasta ainm a luaíonn an tacar sonraí agus an dáta (customer_reviews_2026_11_02) a aimsiú sa liosta baisceanna agus i gconsól xAI, a ligeann duit baisceanna a rianú go amhairc freisin.

Tabhair faoi deara an t-éag: léiríonn expire_time cathain a stopfar rochtain ar an mbaisc agus ar a torthaí. Caithfidh do phróiseas aisghabhála rith roimh an am sin.

Láimhseáil earráidí cruthaithe: d’fhéadfadh earráid fíordheimhniúcháin, sárú teorann ráta, nó fadhb líonra cosc a chur ar chruthú. Déan iarracht arís ar earráidí sealadacha le moill mhéadaitheach (exponential backoff), ach ná déan iarracht arís riamh ar earráidí fíordheimhniúcháin.

Príomhphointí

  • Is é cruthú baisce ná POST /v1/batches nach bhfuil ann ach an réimse riachtanach name
  • Áirítear sa fhreagra batch_id uathúil le coinneáil don chuid eile den sruth oibre
  • I bPython, nochtann an SDK oifigiúil xai-sdk an modh client.batch.create(batch_name=...)
  • Is é an teorainn ná 2 chruthú in aghaidh an tsoicind in aghaidh an fhoirne, gan teorainn ar líon na mbaisceanna
  • Bí airdeallach ar expire_time agus déan iarracht arís ach ar earráidí sealadacha amháin