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

Punkty końcowe obsługiwane w trybie wsadowym

Lekcja 3 z 12 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Siedem punktów końcowych, jeden przepływ pracy
  2. Punkty końcowe dla tekstu
  3. Punkty końcowe dla obrazów
  4. Punkty końcowe dla wideo
  5. Mieszanie punktów końcowych w ramach wsadu
  6. Wybór właściwego punktu końcowego
  7. Kluczowe wnioski

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 url w 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ę.