Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Tühja partii loomine

Õppetund 4 / 12 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Esimene samm: initsialiseerimine
  2. Loomise päring
  3. Pythoni teostus
  4. JavaScripti teostus
  5. Loomise kiirusepiirangud
  6. Parimad tavad
  7. Peamised punktid

Uuendatud 2. novembril 2026 xAI dokumentatsiooni põhjal: partii soodustus on sobivate tekst mudelite puhul 20% (mitte 50%), näited kasutavad REST API-t ja ametlikku xai-sdk SDK-d (client.batch.*; xAI partii API ei kasuta OpenAI vormingut, seega OpenAI SDK ei kehti) ning Responses API-l on vestluse lõpetamise (Chat Completions) ees esikoht, mis on xAI-s iganenud lõpp-punkt. Allikad: Partii API · REST viide · Partii hinnakiri.

Esimene samm: initsialiseerimine

Partii loomine on sinu töövoos esimene konkreetne tegevus. POST /v1/batches päring initsialiseerib tühja konteineri, kuhu seejärel su päringud lisatakse. See samm on tahtlikult minimaalne: see loob identifikaatori ja valmistab partii serveripoolselt ette.

1

POST /v1/batches

Loob nimetatud partii ja tagastab selle batch_id.

2

Salvesta batch_id

Salvesta identifikaator hilisemate toimingute jaoks.

3

Lisa päringud

Partii on valmis API kaudu päringuid vastu võtma.

Loomise päring

Päringu keha sisaldab ainult ühte kohustuslikku välja, 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"}'

Vastus sisaldab batch_id, loomise ja aegumise kuupäevi ning partii loendureid, mis on veel nullis (näide API viitest):

{
  "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
  }
}

Pythoni teostus

Ametlik SDK paigaldatakse käsuga pip install xai-sdk (versioon 1.21.0 seisuga 2. november 2026; vajalik Python 3.10 või uuem). See loeb võtme keskkonnamuutujast 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}")

Tagastatud batch_id on sinu partii unikaalne viide. Hoia seda muutujas, failis või andmebaasis, sõltuvalt sinu arhitektuurist.

JavaScripti teostus

Ilma SDK-ta piisab lihtsast fetch päringust REST API-le:

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

Loomise kiirusepiirangud

Partii loomine on piiratud 2 loomisega sekundis meeskonna kohta; partii endi arv ei ole piiratud. Praktikas jõuad sa sellele piirangule harva: tavaliselt lood ühe partii toimingu kohta ja lisad sinna kõik oma päringud. Kui lood tsüklis mitu partiid, jäta kõnede vahele vähemalt 500 millisekundit.

Parimad tavad

Nimeta oma partiisid hoolikalt: nimi on kohustuslik, seega tee see kasulikuks. Nimi, mis sisaldab andmestiku ja kuupäeva (customer_reviews_2026_11_02), on lihtne leida partii loendist ja xAI konsoolist, mis võimaldab partiisid ka visuaalselt jälgida.

Pane tähele aegumist: expire_time näitab, millal partii ja selle tulemused muutuvad kättesaamatuks. Sinu andmete hankimise protsess peab toimuma enne seda tähtaega.

Käsitle loomisvigu: autentimisviga, kiirusepiirangu ületamine või võrguprobleem võib takistada loomist. Proovi mööduvaid vigu uuesti kasvava viitega (eksponentsiaalne tagasipöördumine), kuid ära kunagi proovi uuesti autentimisvigu.

Peamised punktid

  • Partii loomine on POST /v1/batches, mille ainus kohustuslik väli on name
  • Vastus sisaldab unikaalset batch_id, mida tuleb ülejäänud töövoos säilitada
  • Pythonis annab ametlik xai-sdk SDK juurdepääsu meetodile client.batch.create(batch_name=...)
  • Piirang on 2 loomist sekundis meeskonna kohta, partii arvule piirangut ei ole
  • Jälgi expire_time ja proovi uuesti ainult mööduvaid vigu