Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Izveidot tukšu kopu

Nodarbība 4 no 12 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Pirmais solis: inicializācija
  2. Izveides izsaukums
  3. Implementācija Python valodā
  4. Implementācija JavaScript valodā
  5. Izveides ātruma ierobežojumi
  6. Labākā prakse
  7. Galvenās atziņas

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-sdk SDK (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ē.

1

POST /v1/batches

Izveido nosauktu kopu un atgriež tās batch_id.

2

Saglabā batch_id

Saglabā identifikatoru turpmākajām operācijām.

3

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/batches izsaukums, kurā vienīgais obligātais lauks ir name
  • Atbilde satur unikālu batch_id, kas jāsaglabā turpmākajai darbplūsmai
  • Python valodā oficiālais xai-sdk SDK piedāvā metodi client.batch.create(batch_name=...)
  • Limits ir 2 izveides sekundē vienai komandai, bez limita kopu skaitam
  • Uzraugi expire_time un atkārto tikai pārejošas kļūdas