Ustvari prazno serijo
Na tej strani
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.
POST /v1/batches
Ustvari poimenovano serijo in vrne njen batch_id.
Shrani batch_id
Shrani identifikator za poznejše operacije.
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 jename - Odgovor vsebuje edinstven
batch_id, ki ga obdržiš za preostanek delovnega toka - V Pythonu uradni SDK
xai-sdkomogočaclient.batch.create(batch_name=...) - Omejitev je 2 ustvarjanji na sekundo na ekipo, brez omejitve števila serij
- Spremljaj
expire_timein ponovno poskusi le prehodne napake