Izveidot tukšu kopu
Šajā lapā
Atjaunināts 2026. gada 2. novembrī, pamatojoties uz xAI dokumentāciju: atlaide kopām ir 20% atbilstošajiem teksta modeļiem (nevis 50%), piemēros izmantota REST API un oficiālais
xai-sdkSDK (client.batch.*; xAI Batch API neizmanto OpenAI formātu, tāpēc OpenAI SDK nav piemērojams), un Responses API ir prioritāte pār Chat Completions, kas xAI ir novecojis galapunkts. Avoti: Batch API · REST atsauce · Kopu cenas.
Pirmais solis: inicializācija
Kopas izveide ir pirmā konkrētā darbība tavā darbplūsmā. Izsaucot POST /v1/batches, tiek inicializēts tukšs konteiners, kurā pēc tam ievietosi savus pieprasījumus. Šis solis ir apzināti minimāls: tas ģenerē identifikatoru un sagatavo kopu servera pusē.
POST /v1/batches
Izveido nosauktu kopu un atgriež tās batch_id.
Saglabā batch_id
Saglabā identifikatoru turpmākajām operācijām.
Pievieno pieprasījumus
Kopa ir gatava saņemt pieprasījumus, izmantojot API.
Izveides izsaukums
Pieprasījuma struktūrā ir tikai viens obligāts lauks – 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"}'
Atbilde satur batch_id, izveides un derīguma termiņa datumus, kā arī kopas skaitītājus, kas vēl ir nulles vērtībā (piemērs no API atsauces):
{
"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
}
}
Implementācija Python valodā
Oficiālo SDK instalē ar komandu pip install xai-sdk (versija 1.21.0, spēkā no 2026. gada 2. novembra; nepieciešama Python 3.10 vai jaunāka). Tas nolasa atslēgu no vides mainīgā 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}")
Atgrieztais batch_id ir unikāla atsauce uz tavu kopu. Saglabā to mainīgajā, failā vai datubāzē atkarībā no tavas arhitektūras.
Implementācija JavaScript valodā
Bez SDK pietiek ar vienkāršu fetch izsaukumu uz REST API:
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}`);
Izveides ātruma ierobežojumi
Kopu izveide ir ierobežota līdz 2 reizēm sekundē vienai komandai; pašu kopu skaitam nav limita. Praksē šo limitu sasniegsi reti: parasti izveido vienu kopu katrai operācijai un pēc tam tai pievieno visus pieprasījumus. Ja izveido vairākas kopas ciklā, nodromini vismaz 500 milisekunžu intervālu starp izsaukumiem.
Labākā prakse
Rūpīgi nosauc savas kopas: nosaukums ir obligāts, tāpēc padari to noderīgu. Nosaukums, kas norāda datu kopu un datumu (customer_reviews_2026_11_02), ir viegli atrodams kopu sarakstā un xAI konsolē, kas ļauj arī vizuāli izsekot kopām.
Pievērs uzmanību derīguma termiņam: expire_time norāda brīdi, kad kopa un tās rezultāti vairs nebūs pieejami. Tavi datu ieguves procesi jāpabeidz pirms šī laika.
Apstrādā izveides kļūdas: autentifikācijas kļūda, ātruma limita pārsniegšana vai tīkla problēma var novērst izveidi. Pārejošas kļūdas mēģini atkārtot ar pieaugošu aizkavi (eksponenciāla atkāpe), bet nekad neatkārto autentifikācijas kļūdas.
Galvenās atziņas
- Kopas izveide ir
POST /v1/batchesizsaukums, kurā vienīgais obligātais lauks irname - Atbilde satur unikālu
batch_id, kas jāsaglabā turpmākajai darbplūsmai - Python valodā oficiālais
xai-sdkSDK piedāvā metodiclient.batch.create(batch_name=...) - Limits ir 2 izveides sekundē vienai komandai, bez limita kopu skaitam
- Uzraugi
expire_timeun atkārto tikai pārejošas kļūdas