Cruthaigh baisc fholamh
Ar an leathanach seo
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í.
POST /v1/batches
Cruthaíonn sé baisc ainmnithe agus filleann sé a batch_id.
Stóráil an batch_id
Sábháil an t-aitheantóir le haghaidh oibríochtaí ina dhiaidh sin.
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/batchesnach bhfuil ann ach an réimse riachtanachname - Áirítear sa fhreagra
batch_iduathúil le coinneáil don chuid eile den sruth oibre - I bPython, nochtann an SDK oifigiúil
xai-sdkan modhclient.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_timeagus déan iarracht arís ach ar earráidí sealadacha amháin