Punkty końcowe obsługiwane w trybie wsadowym
Na tej stronie
Zaktualizowano 2 listopada 2026 r. na podstawie dokumentacji xAI: rabat wsadowy wynosi 20% dla kwalifikujących się modeli tekstowych (a nie 50%), przykłady opierają się na interfejsie REST oraz oficjalnym
xai-sdk(client.batch.*; interfejs Batch API firmy xAI nie korzysta z formatu OpenAI, więc SDK OpenAI nie ma zastosowania), a interfejs Responses API ma pierwszeństwo przed Chat Completions, który jest w xAI punktem końcowym przestarzałym. Źródła: Batch API · Referencje REST · Cennik Batch API.
Siedem punktów końcowych, jeden przepływ pracy
Interfejs Batch API nie ogranicza się do generowania tekstu. Akceptuje siedem punktów końcowych obejmujących tekst, obrazy i wideo, które możesz mieszać w ramach jednej wsadowej operacji, aby budować kompletne potoki multimodalne.
Punkty końcowe dla tekstu
/v1/responses — Interfejs Responses API, rekomendowany przez xAI. Zapewnia dostęp do narzędzi po stronie serwera (wyszukiwanie w sieci, wyszukiwanie w serwisie X, wykonywanie kodu, MCP), wywoływanie funkcji oraz strukturalne dane wyjściowe, a także jako pierwszy otrzymuje nowe funkcje.
/v1/chat/completions — Oryginalny punkt końcowy uzupełnień w formacie OpenAI. xAI utrzymuje go jako punkt przestarzały: nadal przydaje się do istniejącego kodu napisanego pod ten interfejs, ale nowy potok warto zacząć od Responses.
Dla kwalifikujących się modeli rabat wsadowy w wysokości 20% dotyczy obu punktów końcowych i wszystkich typów tokenów.
Punkty końcowe dla obrazów
/v1/images/generations — Generuje obrazy na podstawie monitu. Parametry, których użyjesz, to aspect_ratio (na przykład "16:9"), resolution ("1k", "1.5k" lub "2k"), n określające liczbę obrazów oraz response_format ("url" lub "b64_json").
/v1/images/edits — Edytuje istniejący obraz, określony przez obiekt image zawierający url (publiczny adres lub dane zakodowane w base64) lub file_id przesłanego pliku. Przydatne do uruchamiania serii transformacji na katalogu wizualnym.
Obrazy są rozliczane według stawki standardowej, bez rabatu wsadowego: wartością dodaną batchowania jest tu aspekt operacyjny, a nie finansowy.
Punkty końcowe dla wideo
/v1/videos/generations (lub /v1/videos) — Generuje wideo na podstawie monitu, o długości od 1 do 15 sekund (duration, domyślnie 8), w rozdzielczościach 480p, 720p lub 1080p.
/v1/videos/edits — Edytuje istniejące wideo, przekazywane w obiekcie video (URL pliku .mp4 lub file_id).
/v1/videos/extensions — Rozszerza wideo o nowy segment trwający od 2 do 10 sekund.
Podobnie jak w przypadku obrazów, ceny wideo w trybie wsadowym pozostają na poziomie stawki standardowej. Wyniki dla obrazów i wideo są zwracane jako podpisane adresy URL wygasające po jednej godzinie.
Mieszanie punktów końcowych w ramach wsadu
W pliku JSONL każda linia wskazuje swój punkt końcowy w polu url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}
W ten sposób możesz wygenerować opisy produktów i odpowiadające im wizualizacje w ramach tej samej operacji wsadowej.
Wybór właściwego punktu końcowego
- Responses: wybór domyślny, niezbędny, gdy potrzebujesz narzędzi po stronie serwera, strukturalnych danych wyjściowych lub najnowszych funkcji.
- Chat Completions: ciągłość dla kodu napisanego już w formacie Chat Completions i nic więcej.
- Obrazy i wideo: do seriiowej produkcji materiałów wizualnych, z zastrzeżeniem, że nie przysługuje na nie rabat.
Kluczowe wnioski
- Akceptowanych jest siedem punktów końcowych: dwa dla tekstu, dwa dla obrazów, trzy dla wideo.
- Responses to rekomendowany punkt końcowy; Chat Completions to w xAI punkt przestarzały.
- Rabat 20% dotyczy wyłącznie tokenów generowanych przez kwalifikujące się modele tekstowe.
- Pole
urlw każdej linii pliku JSONL określa docelowy punkt końcowy; punkty te można mieszać w ramach jednego wsadu. - Wyniki dla obrazów i wideo to podpisane adresy URL ważne przez jedną godzinę.