Sukurti tuščią grupę
Šiame puslapyje
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-sdkSDK (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.
POST /v1/batches
Sukuria įvardytą grupę ir grąžina jos batch_id.
Išsaugok batch_id
Išsaugok identifikatorių vėlesniems veiksmams.
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 yraname - Atsakyme gaunamas unikalus
batch_id, kurį reikia saugoti visai darbo eigai - Python kalboje oficialus
xai-sdkSDK pateikia metodąclient.batch.create(batch_name=...) - Ribojimas yra 2 kūrimai per sekundę vienai komandai, o grupių skaičius neribojamas
- Stebėk
expire_timeir kartok tik laikinas klaidas