Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Ustvari prazno serijo

Lekcija 4 od 12 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Prvi korak: inicializacija
  2. Klic za ustvarjanje
  3. Implementacija v Pythonu
  4. Implementacija v JavaScriptu
  5. Omejitve hitrosti ustvarjanja
  6. Najboljše prakse
  7. Ključne ugotovitve

Posodobljeno 2. novembra 2026 na podlagi dokumentacije xAI: popust za serije znaša 20 % za ustrezne besedilne modele (ne 50 %), primeri uporabljajo REST API in uradni SDK xai-sdk (client.batch.*; Batch API xAI ne uporablja formata OpenAI, zato SDK OpenAI ne velja), API Responses pa ima prednost pred Chat Completions, ki je zastarela končna točka pri xAI. Viri: Batch API · Referenca REST · Cenik za serije.

Prvi korak: inicializacija

Ustvarjanje serije je prvo konkretno dejanje v tvojem delovnem toku. Klic POST /v1/batches inicializira prazen zabojnik, ki bo nato prejel tvoje zahteve. Ta korak je namerno minimalističen: ustvari identifikator in pripravi serijo na strani strežnika.

1

POST /v1/batches

Ustvari poimenovano serijo in vrne njen batch_id.

2

Shrani batch_id

Shrani identifikator za poznejše operacije.

3

Dodaj zahteve

Serija je pripravljena na prejemanje zahtev prek API-ja.

Klic za ustvarjanje

Telo zahteve vsebuje samo eno obvezno polje, 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"}'

Odgovor vsebuje batch_id, datuma ustvarjanja in poteka ter števce serije, ki so še vedno ničelni (primer iz reference 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
  }
}

Implementacija v Pythonu

Uradni SDK namestiš z pip install xai-sdk (različica 1.21.0 z dne 2. novembra 2026; najmanj Python 3.10). Ključ prebere iz okoljske spremenljivke 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}")

Vrnjeni batch_id je edinstvena referenca za tvojo serijo. Shrani ga v spremenljivko, datoteko ali bazo podatkov, odvisno od tvoje arhitekture.

Implementacija v JavaScriptu

Brez SDK-ja zadostuje preprost fetch do REST API-ja:

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

Omejitve hitrosti ustvarjanja

Ustvarjanje serij je omejeno na 2 na sekundo na ekipo; število samih serij ni omejeno. V praksi boš to omejitev redko dosegel: običajno ustvariš eno serijo na operacijo, nato pa ji dodaš vse svoje zahteve. Če ustvarjaš več serij v zanki, razmakni klice vsaj 500 milisekund narazen.

Najboljše prakse

Skrbno poimenuj svoje serije: ime je obvezno, zato naj bo uporabno. Ime, ki navaja nabor podatkov in datum (customer_reviews_2026_11_02), je enostavno najti na seznamu serij in v konzoli xAI, ki ti omogoča tudi vizualno sledenje serijam.

Upoštevaj potek veljavnosti: expire_time označuje, kdaj serija in njeni rezultati prenehajo biti dostopni. Tvoj postopek pridobivanja mora potekati pred tem trenutkom.

Obvladuj napake pri ustvarjanju: napaka pri avtentikaciji, presežena omejitev hitrosti ali težava z omrežjem lahko preprečita ustvarjanje. Ponovni poskusi prehodnih napak z naraščajočim zamikom (eksponentno nazadovanje), nikoli pa ne ponavljaj napak pri avtentikaciji.

Ključne ugotovitve

  • Ustvarjanje serije je POST /v1/batches, katerega edino obvezno polje je name
  • Odgovor vsebuje edinstven batch_id, ki ga obdržiš za preostanek delovnega toka
  • V Pythonu uradni SDK xai-sdk omogoča client.batch.create(batch_name=...)
  • Omejitev je 2 ustvarjanji na sekundo na ekipo, brez omejitve števila serij
  • Spremljaj expire_time in ponovno poskusi le prehodne napake