Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Üres köteg létrehozása

4. lecke 12 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Első lépés: inicializálás
  2. A létrehozó hívás
  3. Python megvalósítás
  4. JavaScript megvalósítás
  5. Létrehozási sebességkorlátok
  6. Legjobb gyakorlatok
  7. Főbb megállapítások

Frissítve: 2026. november 2. az xAI dokumentációja alapján: a kötegelt kedvezmény 20% a jogosult szöveges modelleken (nem 50%), a példák a REST API-t és a hivatalos xai-sdk SDK-t használják (client.batch.*; az xAI Kötegelt API-ja nem az OpenAI formátumát követi, így az OpenAI SDK nem alkalmazható), és a Responses API elsőbbséget élvez a Chat Completionshez képest, amely az xAI-nál már elavult végpont. Források: Batch API · REST referencia · Batch pricing.

Első lépés: inicializálás

A köteg létrehozása a munkafolyamatod első konkrét lépése. Egy POST /v1/batches hívás inicializál egy üres tárolót, amely majd megkapja a kéréseidet. Ez a lépés szándékosan minimális: létrehozza az azonosítót, és előkészíti a köteget a szerveroldalon.

1

POST /v1/batches

Létrehoz egy elnevezett köteget, és visszaadja a batch_id értékét.

2

A batch_id tárolása

Mentsd el az azonosítót a későbbi műveletekhez.

3

Kérések hozzáadása

A köteg készen áll a kérések fogadására az API-n keresztül.

A létrehozó hívás

A kérés törzse csak egyetlen kötelező mezőt tartalmaz, a name-et:

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"}'

A válasz tartalmazza a batch_id-t, a létrehozás és a lejárat dátumát, valamint a köteg számlálóit, amelyek még nullán állnak (példa az API referenciából):

{
  "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
  }
}

Python megvalósítás

A hivatalos SDK a pip install xai-sdk paranccsal telepíthető (2026. november 2-i állapot szerint az 1.21.0 verzió; minimum Python 3.10 szükséges). A kulcsot a XAI_API_KEY környezeti változóból olvassa be:

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}")

A visszakapott batch_id a köteged egyedi hivatkozása. Tartsd meg egy változóban, fájlban vagy adatbázisban, az architektúrádtól függően.

JavaScript megvalósítás

SDK nélkül egy egyszerű fetch hívás a REST API felé elég:

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

Létrehozási sebességkorlátok

A kötegek létrehozása csapatonként másodpercenként 2 műveletre korlátozott; magának a kötegek számának nincs felső határa. A gyakorlatban ezt a limitet ritkán éred el: általában műveletenként egy köteget hozol létre, majd ahhoz adod hozzá az összes kérésedet. Ha ciklusban hozol létre többet is, legalább 500 milliszekundummal időzítsd el a hívásokat.

Legjobb gyakorlatok

Nevezd el gondosan a kötegeidet: a név kötelező, ezért tedd hasznossá. Egy olyan név, amely jelzi az adathalmazt és a dátumot (customer_reviews_2026_11_02), könnyen megtalálható a köteglistában és az xAI konzolban, amely lehetővé teszi a kötegek vizuális nyomon követését is.

Jegyezd fel a lejáratot: az expire_time azt jelzi, mikor válik hozzáférhetetlenné a köteg és annak eredménye. A lekérési folyamatodnak ez előtt le kell futnia.

Kezeld a létrehozási hibákat: hitelesítési hiba, sebességkorlát túllépése vagy hálózati probléma megakadályozhatja a létrehozást. Az átmeneti hibákat növekvő késleltetéssel (exponenciális visszalépés) érdemes újrapróbálni, de a hitelesítési hibákat soha ne próbáld újra.

Főbb megállapítások

  • A köteg létrehozása egy POST /v1/batches hívás, amelynek egyetlen kötelező mezője a name
  • A válasz egy egyedi batch_id-t tartalmaz, amelyet a munkafolyamat hátralévő részében meg kell őrizni
  • Pythonban a hivatalos xai-sdk SDK a client.batch.create(batch_name=...) metódust teszi elérhetővé
  • A korlát csapatonként másodpercenként 2 létrehozás, a kötegek számára nincs felső határ
  • Figyeld az expire_time értékét, és csak az átmeneti hibákat próbáld újra