Crearea unui lot gol
Pe această pagină
Actualizat pe 2 noiembrie 2026 pe baza documentației xAI: reducerea pentru loturi este de 20% la modelele de text eligibile (nu 50%), exemplele utilizează API-ul REST și SDK-ul oficial
xai-sdk(client.batch.*; API-ul Batch de la xAI nu folosește formatul OpenAI, deci SDK-ul OpenAI nu se aplică), iar API-ul Responses are prioritate față de Chat Completions, un endpoint legacy la xAI. Surse: Batch API · Referință REST · Prețuri Batch.
Primul pas: inițializarea
Crearea unui lot reprezintă prima acțiune concretă din fluxul dumneavoastră de lucru. Un apel POST /v1/batches inițializează un container gol care va primi ulterior cererile dumneavoastră. Acest pas este intenționat minimal: creează identificatorul și pregătește lotul la nivel de server.
POST /v1/batches
Creează un lot denumit și returnează batch_id-ul acestuia.
Stocarea batch_id
Salvați identificatorul pentru operațiunile ulterioare.
Adăugarea cererilor
Lotul este gata să primească cereri prin intermediul API-ului.
Apelul de creare
Corpul cererii conține un singur câmp obligatoriu, 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"}'
Răspunsul conține batch_id, datele de creare și expirare, precum și contoarele lotului, toate fiind inițial zero (exemplu din referința API):
{
"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
}
}
Implementare în Python
SDK-ul oficial se instalează cu pip install xai-sdk (versiunea 1.21.0 la data de 2 noiembrie 2026; necesită Python 3.10 sau superior). Acesta citește cheia din variabila de mediu 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}")
batch_id returnat este referința unică pentru lotul dumneavoastră. Păstrați-l într-o variabilă, într-un fișier sau într-o bază de date, în funcție de arhitectura dumneavoastră.
Implementare în JavaScript
Fără un SDK, un simplu fetch către API-ul REST este suficient:
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}`);
Limite de rată pentru creare
Crearea loturilor este limitată la 2 pe secundă per echipă; numărul total de loturi nu este limitat. În practică, rareori veți atinge această limită: de obicei creați un singur lot per operațiune, apoi adăugați toate cererile în acesta. Dacă creați mai multe loturi într-o buclă, spațiați apelurile la cel puțin 500 de milisecunde distanță.
Cele mai bune practici
Denumiți loturile cu atenție: numele este obligatoriu, așa că faceți-l util. Un nume care indică setul de date și data (customer_reviews_2026_11_02) este ușor de găsit în lista de loturi și în consola xAI, care vă permite, de asemenea, să urmăriți loturile vizual.
Rețineți data de expirare: expire_time indică momentul până la care lotul și rezultatele sale rămân accesibile. Procesul dumneavoastră de preluare trebuie să ruleze înainte de acest termen.
Gestionați erorile de creare: o eroare de autentificare, depășirea limitei de rată sau o problemă de rețea pot împiedica crearea. Reîncercați erorile tranzitorii cu o întârziere crescătoare (exponential backoff), dar nu reîncercați niciodată erorile de autentificare.
Puncte cheie
- Crearea unui lot este un
POST /v1/batchesal cărui singur câmp obligatoriu estename - Răspunsul conține un
batch_idunic pe care trebuie să îl păstrați pentru restul fluxului de lucru - În Python, SDK-ul oficial
xai-sdkexpune metodaclient.batch.create(batch_name=...) - Limita este de 2 creări pe secundă per echipă, fără o limită superioară a numărului de loturi
- Monitorizați
expire_timeși reîncercați doar erorile tranzitorii