Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Oħloq batch vojt

Lezzjoni 4 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-ewwel pass: l-inizjalizzazzjoni
  2. Is-sejħa tal-ħolqien
  3. Implimentazzjoni f’Python
  4. Implimentazzjoni f’JavaScript
  5. Limiti tar-rata tal-ħolqien
  6. L-aħjar prattiki
  7. Punti Ewlenin

Aġġornat fit-2 ta’ Novembru, 2026 abbażi tad-dokumentazzjoni ta’ xAI: l-iskont tal-batch huwa 20% fuq mudelli ta’ test eliġibbli (mhux 50%), l-eżempji jużaw l-API REST u l-SDK uffiċjali xai-sdk (client.batch.*; l-API tal-Batch ta’ xAI ma tużax il-format ta’ OpenAI, allura l-SDK ta’ OpenAI ma japplikax), u l-API tar-Risposti tieħu preċedenza fuq Chat Completions, li huwa endpoint antikwat f’xAI. Sorsi: Batch API · Referenza REST · Prezzijiet tal-Batch.

L-ewwel pass: l-inizjalizzazzjoni

Il-ħolqien ta’ batch huwa l-ewwel azzjoni konkreta fil-fluss tax-xogħol tiegħek. Sejħa POST /v1/batches tinizjalizza kontenitur vojt li mbagħad jirċievi t-talbiet tiegħek. Dan il-pass huwa deliberatament minimu: joħloq l-identifikatur u jħejji l-batch fuq in-naħa tas-server.

1

POST /v1/batches

Joħloq batch imsemmi u jirritorna l-batch_id tiegħu.

2

Aħżen il-batch_id

Salva l-identifikatur għal operazzjonijiet futuri.

3

Żid it-talbiet

Il-batch huwa lest biex jirċievi talbiet permezz tal-API.

Is-sejħa tal-ħolqien

Il-korp tat-talba fih kamp obbligatorju wieħed biss, 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-risposta fiha l-batch_id, id-dati tal-ħolqien u tal-iskadenza, u l-kontaturi tal-batch, li għadhom żero (eżempju mir-referenza tal-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
  }
}

Implimentazzjoni f’Python

L-SDK uffiċjali jiġi installat b’pip install xai-sdk (verżjoni 1.21.0 sal-2 ta’ Novembru 2026; Python 3.10 minimu). Jaqra ċ-ċavetta mill-varjabbli tal-ambjent 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}")

Il-batch_id ritornat huwa r-referenza unika għall-batch tiegħek. Żommu f’varjabbli, f’fajl, jew f’database, skont l-arkitettura tiegħek.

Implimentazzjoni f’JavaScript

Mingħajr SDK, fetch sempliċi lejn l-API REST huwa biżżejjed:

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}`);

Limiti tar-rata tal-ħolqien

Il-ħolqien tal-batch huwa limitat għal 2 kull sekonda għal kull tim; in-numru ta’ batches innifsu mhuwiex limitat. Fil-prattika, rari se tilħaq dan il-limitu: ġeneralment toħloq batch wieħed għal kull operazzjoni, imbagħad iżżid it-talbiet kollha tiegħek fih. Jekk toħloq diversi f’loop, ħalli spazju ta’ mill-inqas 500 millisekonda bejn is-sejħiet.

L-aħjar prattiki

Semmi l-batches tiegħek bir-reqqa: l-isem huwa meħtieġ, allura agħmlu utli. Isem li jindika d-dataset u d-data (customer_reviews_2026_11_02) huwa faċli biex issibu fil-lista tal-batches u fil-konsowl ta’ xAI, li jħallik ukoll issegwi l-batches viżwalment.

Innota l-iskadenza: expire_time tindika meta l-batch u r-riżultati tiegħu jieqfu milli jkunu aċċessibbli. Il-proċess ta’ rkupru tiegħek irid jibda qabel dak iż-żmien.

Immaniġġja l-iżbalji tal-ħolqien: żball fl-awtentikazzjoni, qbiż tal-limitu tar-rata, jew problema fin-netwerk jistgħu jipprevjenu l-ħolqien. Erġa’ pprova l-iżbalji tranżitorji b’dewmien li jiżdied (exponential backoff), iżda qatt terġa’ tipprova żbalji ta’ awtentikazzjoni.

Punti Ewlenin

  • Il-ħolqien ta’ batch huwa POST /v1/batches li l-uniku kamp meħtieġ tiegħu huwa name
  • Ir-risposta fiha batch_id uniku li għandek iżżomm għall-bqija tal-fluss tax-xogħol
  • F’Python, l-SDK uffiċjali xai-sdk jesponi client.batch.create(batch_name=...)
  • Il-limitu huwa 2 ħolqien kull sekonda għal kull tim, mingħajr limitu fuq in-numru ta’ batches
  • Ara expire_time u erġa’ pprova biss żbalji tranżitorji