Salt la conținutul principal
Română— Alege o limbă
Meniu

Crearea unui lot gol

Lecția 4 din 12 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Primul pas: inițializarea
  2. Apelul de creare
  3. Implementare în Python
  4. Implementare în JavaScript
  5. Limite de rată pentru creare
  6. Cele mai bune practici
  7. Puncte cheie

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.

1

POST /v1/batches

Creează un lot denumit și returnează batch_id-ul acestuia.

2

Stocarea batch_id

Salvați identificatorul pentru operațiunile ulterioare.

3

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/batches al cărui singur câmp obligatoriu este name
  • Răspunsul conține un batch_id unic pe care trebuie să îl păstrați pentru restul fluxului de lucru
  • În Python, SDK-ul oficial xai-sdk expune metoda client.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