Przejdź do głównej treści
Polski— Wybierz język
Menu

Tworzenie pustego wsadu

Lekcja 4 z 12 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Pierwszy krok: inicjalizacja
  2. Wywołanie tworzące
  3. Implementacja w Pythonie
  4. Implementacja w JavaScript
  5. Limity częstotliwości tworzenia
  6. Najlepsze praktyki
  7. Kluczowe wnioski

Zaktualizowano 2 listopada 2026 r. na podstawie dokumentacji xAI: rabat na wsady wynosi 20% dla kwalifikujących się modeli tekstowych (a nie 50%), przykłady wykorzystują interfejs REST oraz oficjalny SDK xai-sdk (client.batch.*; API wsadowe xAI nie używa formatu OpenAI, więc SDK OpenAI nie ma zastosowania), a API Responses ma pierwszeństwo przed Chat Completions, które są przestarzałym punktem końcowym w xAI. Źródła: Batch API · Dokumentacja REST · Cennik wsadów.

Pierwszy krok: inicjalizacja

Utworzenie wsadu to pierwsze konkretne działanie w Twoim przepływie pracy. Wywołanie POST /v1/batches inicjuje pusty kontener, do którego następnie trafią Twoje żądania. Ten krok jest celowo minimalistyczny: tworzy identyfikator i przygotowuje wsad po stronie serwera.

1

POST /v1/batches

Tworzy nazwany wsad i zwraca jego batch_id.

2

Zapisz batch_id

Zachowaj identyfikator do późniejszych operacji.

3

Dodaj żądania

Wsad jest gotowy do przyjmowania żądań przez API.

Wywołanie tworzące

Treść żądania zawiera tylko jedno wymagane pole, 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"}'

Odpowiedź zawiera batch_id, daty utworzenia i wygaśnięcia oraz liczniki wsadu, wciąż ustawione na zero (przykład z dokumentacji 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
  }
}

Implementacja w Pythonie

Oficjalny SDK instalujesz poleceniem pip install xai-sdk (wersja 1.21.0 na dzień 2 listopada 2026 r.; wymagany Python 3.10 lub nowszy). Odczytuje on klucz ze zmiennej środowiskowej 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}")

Zwrócony batch_id to unikalny identyfikator Twojego wsadu. Przechowuj go w zmiennej, pliku lub bazie danych, w zależności od architektury systemu.

Implementacja w JavaScript

Bez użycia SDK wystarczy proste wywołanie fetch do interfejsu REST:

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

Limity częstotliwości tworzenia

Tworzenie wsadów jest ograniczone do 2 operacji na sekundę na zespół; sama liczba wsadów nie podlega limitowi. W praktyce rzadko osiągniesz ten pułap: zazwyczaj tworzysz jeden wsad na operację, a następnie dodajesz do niego wszystkie żądania. Jeśli tworzysz kilka wsadów w pętli, rozdziel wywołania co najmniej 500-milisekundowymi odstępami.

Najlepsze praktyki

Nazywaj wsady starannie: nazwa jest wymagana, więc spraw, by była użyteczna. Nazwa określająca zbiór danych i datę (np. customer_reviews_2026_11_02) ułatwia odnalezienie wsadu na liście i w konsoli xAI, która pozwala również wizualnie śledzić postępy.

Zwróć uwagę na wygaśnięcie: pole expire_time wskazuje moment, po którym wsad i jego wyniki przestaną być dostępne. Proces pobierania wyników musi zakończyć się przed tym czasem.

Obsługuj błędy tworzenia: błąd uwierzytelnienia, przekroczenie limitu częstotliwości lub problem sieciowy mogą uniemożliwić utworzenie wsadu. W przypadku błędów przejściowych stosuj ponowne próby z rosnącym opóźnieniem (wykładnicze wycofywanie), ale nigdy nie powtarzaj prób przy błędach uwierzytelnienia.

Kluczowe wnioski

  • Utworzenie wsadu to wywołanie POST /v1/batches, w którym jedynym wymaganym polem jest name
  • Odpowiedź zawiera unikalny batch_id, który musisz zachować na potrzeby dalszych etapów przepływu pracy
  • W Pythonie oficjalny SDK xai-sdk udostępnia metodę client.batch.create(batch_name=...)
  • Limit wynosi 2 utworzenia na sekundę na zespół, bez ograniczeń co do liczby wsadów
  • Monitoruj pole expire_time i powtarzaj tylko błędy przejściowe