Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Sukurti tuščią grupę

Paskaita 4 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Pirmas žingsnis: inicializavimas
  2. Kūrimo užklausa
  3. Įgyvendinimas naudojant Python
  4. Įgyvendinimas naudojant JavaScript
  5. Kūrimo dažnio ribos
  6. Geriausios praktikos
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. pagal xAI dokumentaciją: grupės nuolaida yra 20 % tinkamiems teksto modeliams (ne 50 %), pavyzdžiuose naudojama REST API ir oficialus xai-sdk SDK (client.batch.*; xAI grupės API nenaudoja OpenAI formato, todėl OpenAI SDK netinka), o „Responses API“ turi viršenybę prieš „Chat Completions“, kuris xAI sistemoje yra pasenusi galinė stotis. Šaltiniai: Grupės API · REST nuoroda · Grupės kainodara.

Pirmas žingsnis: inicializavimas

Grupės kūrimas yra pirmas konkretus veiksmas tavo darbo eigoje. Užklausa POST /v1/batches inicializuoja tuščią konteinerį, į kurį vėliau bus siunčiamos tavo užklausos. Šis žingsnis sąmoningai minimalus: jis sukuria identifikatorių ir paruošia grupę serverio pusėje.

1

POST /v1/batches

Sukuria įvardytą grupę ir grąžina jos batch_id.

2

Išsaugok batch_id

Išsaugok identifikatorių vėlesniems veiksmams.

3

Pridėk užklausas

Grupė paruošta gauti užklausas per API.

Kūrimo užklausa

Užklausos kūnas turi tik vieną privalomą lauką – 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"}'

Atsakyme pateikiamas batch_id, sukūrimo ir galiojimo pabaigos datos bei grupės skaitikliai, kurie vis dar yra nuliniai (pavyzdys iš API nuorodos):

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

Įgyvendinimas naudojant Python

Oficialus SDK įdiegiamas komanda pip install xai-sdk (2026 m. lapkričio 2 d. versija 1.21.0; reikia bent Python 3.10). Jis raktą nuskoito iš XAI_API_KEY aplinkos kintamojo:

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

Grąžintas batch_id yra unikali tavo grupės nuoroda. Laikyk jį kintamajame, faile arba duomenų bazėje, priklausomai nuo tavo architektūros.

Įgyvendinimas naudojant JavaScript

Be SDK, pakanka paprastos fetch užklausos į 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}`);

Kūrimo dažnio ribos

Grupių kūrimas apribotas iki 2 per sekundę vienai komandai; pačių grupių skaičius neribojamas. Praktiškai šią ribą pasieksi retai: paprastai vienai operacijai sukuri vieną grupę, o tada į ją pridedi visas savo užklausas. Jei kuri kelias grupes cikle, tarp kvietimų daryk bent 500 milisekundžių pertrauką.

Geriausios praktikos

Atidžiai įvardyk savo grupes: pavadinimas yra privalomas, todėl padaryk jį naudingą. Pavadinimas, kuriame nurodytas duomenų rinkinys ir data (customer_reviews_2026_11_02), leidžia lengvai rasti grupę sąraše ir xAI konsolėje, kurioje taip pat galima vizualiai stebėti grupes.

Atkreipk dėmesį į galiojimo laiką: expire_time nurodo, kada grupė ir jos rezultatai taps neprieinami. Tavo gavimo procesas turi būti įvykdytas iki to laiko.

Tvarkyk kūrimo klaidas: autentifikavimo klaida, viršytas dažnio limitas arba tinklo problema gali sutrukdyti sukurti grupę. Laikinas klaidas bandyk kartoti didėjančiu delsos laiku (eksponentinis atsitraukimas), tačiau niekada nekartok autentifikavimo klaidų.

Svarbiausi punktai

  • Grupės kūrimas yra POST /v1/batches, kurio vienintelis privalomas laukas yra name
  • Atsakyme gaunamas unikalus batch_id, kurį reikia saugoti visai darbo eigai
  • Python kalboje oficialus xai-sdk SDK pateikia metodą client.batch.create(batch_name=...)
  • Ribojimas yra 2 kūrimai per sekundę vienai komandai, o grupių skaičius neribojamas
  • Stebėk expire_time ir kartok tik laikinas klaidas