Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Stvaranje prazne serije

Lekcija 4 od 12 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Prvi korak: inicijalizacija
  2. Poziv za stvaranje
  3. Implementacija u Pythonu
  4. Implementacija u JavaScriptu
  5. Ograničenja stope stvaranja
  6. Najbolje prakse
  7. Ključne točke

Ažurirano 2. studenoga 2026. na temelju dokumentacije xAI: popust za serije iznosi 20% na kvalificirane tekstualne modele (ne 50%), primjeri koriste REST API i službeni SDK xai-sdk (client.batch.*; Batch API xAI-ja ne koristi format OpenAI-ja, stoga se SDK OpenAI-ja ne primjenjuje), a Responses API ima prednost nad Chat Completions, koji je kod xAI-ja zastarjela krajnja točka. Izvori: Batch API · REST referenca · Cijene serija.

Prvi korak: inicijalizacija

Stvaranje serije prvi je konkretni korak u tvom radnom tijeku. Poziv POST /v1/batches inicijalizira prazan kontejner koji će zatim primiti tvoje zahtjeve. Ovaj je korak namjerno minimalan: stvara identifikator i priprema seriju na strani poslužitelja.

1

POST /v1/batches

Stvara imenovanu seriju i vraća njezin batch_id.

2

Pohrani batch_id

Spremi identifikator za kasnije operacije.

3

Dodaj zahtjeve

Serija je spremna primiti zahtjeve putem API-ja.

Poziv za stvaranje

Tijelo zahtjeva sadrži samo jedno obavezno 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 sadrži batch_id, datume stvaranja i isteka te brojače serije, koji su još uvijek na nuli (primjer iz reference API-ja):

{
  "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 u Pythonu

Službeni SDK instaliraš s pip install xai-sdk (verzija 1.21.0 od 2. studenoga 2026.; minimalno Python 3.10). On čita ključ iz varijable okoline 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}")

Vraćeni batch_id jedinstvena je referenca za tvoju seriju. Zadrži ga u varijabli, datoteci ili bazi podataka, ovisno o tvojoj arhitekturi.

Implementacija u JavaScriptu

Bez SDK-a, jednostavan fetch prema REST API-ju dovoljan je:

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

Ograničenja stope stvaranja

Stvaranje serija ograničeno je na 2 po sekundi po timu; sam broj serija nije ograničen. U praksi ćeš rijetko doseći ovo ograničenje: obično stvaraš jednu seriju po operaciji, a zatim joj dodaješ sve svoje zahtjeve. Ako stvaraš nekoliko u petlji, razmakni pozive najmanje 500 milisekundi.

Najbolje prakse

Pažljivo imenuj svoje serije: ime je obavezno, zato ga učini korisnim. Ime koje navodi skup podataka i datum (customer_reviews_2026_11_02) lako je pronaći na popisu serija i u xAI konzoli, koja ti također omogućuje vizualno praćenje serija.

Zabilježi vrijeme isteka: expire_time označava kada serija i njezini rezultati prestaju biti dostupni. Tvoj proces dohvaćanja mora se izvršiti prije tog trenutka.

Rukuj pogreškama pri stvaranju: pogreška autentifikacije, premašenje ograničenja stope ili mrežni problem mogu spriječiti stvaranje. Ponovno pokušaj prolazne pogreške s povećanim kašnjenjem (eksponencijalno povlačenje), ali nikada ponovno ne pokušavaj s pogreškama autentifikacije.

Ključne točke

  • Stvaranje serije je POST /v1/batches čije je jedino obavezno polje name
  • Odgovor sadrži jedinstveni batch_id koji trebaš zadržati za ostatak radnog tijeka
  • U Pythonu, službeni SDK xai-sdk izlaže client.batch.create(batch_name=...)
  • Ograničenje je 2 stvaranja po sekundi po timu, bez ograničenja broja serija
  • Prati expire_time i ponovno pokušaj samo prolazne pogreške