Kötegelt műveletekben támogatott végpontok
Ezen az oldalon
Frissítve: 2026. november 2., az xAI dokumentációja alapján: a kötegelt kedvezmény 20% a jogosult szöveges modelleken (nem 50%), a példák a REST API-t és a hivatalos
xai-sdk-t (client.batch.*) követik (az xAI Batch API-ja nem az OpenAI formátumát használja, így az OpenAI SDK nem alkalmazható), és a Responses API elsőbbséget élvez a Chat Completionshez képest, amely az xAI-nál már elavult végpontnak számít. Források: Batch API · REST hivatkozás · Batch árazás.
Hét végpont, egyetlen munkafolyamat
A Batch API nem korlátozódik csupán a szöveggenerálásra. Hét különböző végpontot fogad el, amelyek lefedik a szöveget, a képeket és a videókat. Ezeket egyetlen kötegben is keverheted, hogy egy művelettel teljes multimodális folyamatokat építs fel.
Szöveges végpontok
/v1/responses — A Responses API, amelyet az xAI ajánl. Hozzáférést biztosít a szerveroldali eszközökhöz (webes keresés, X keresés, kódvégrehajtás, MCP), a függvényhívásokhoz és a strukturált kimenetekhez, valamint ez kapja meg elsőként az új funkciókat.
/v1/chat/completions — Az eredeti kiegészítő (completion) végpont az OpenAI formátumában. Az xAI elavult végpontként tartja fenn: még mindig hasznos a már erre írt meglévő kódok esetén, de egy új folyamatot érdemes közvetlenül a Responses API-val indítani.
A jogosult modelleknél a 20%-os kötegelt kedvezmény mindkét végpontra vonatkozik, minden tokentípus esetén.
Képes végpontok
/v1/images/generations — Képeket generál egy lekérdezés (prompt) alapján. A használandó paraméterek: aspect_ratio (például "16:9"), resolution ("1k", "1.5k" vagy "2k"), n a képek számához, valamint response_format ("url" vagy "b64_json").
/v1/images/edits — Egy meglévő képet szerkeszt, amelyet egy image objektum határoz meg; ez tartalmazhat egy url-t (nyilvános cím vagy base64-kódolt adat) vagy egy feltöltött fájl file_id-jét. Hasznos transzformációk sorozatos futtatásához egy vizuális katalóguson belül.
A képek számlázása a szokásos díjszabás szerint történik, kötegelt kedvezmény nélkül: itt a kötegelés értéke operatív, nem pedig pénzügyi jellegű.
Videós végpontok
/v1/videos/generations (vagy /v1/videos) — Videókat generál egy lekérdezés alapján, 1 és 15 másodperc közötti hosszúságban (duration, alapértelmezetten 8), 480p, 720p vagy 1080p felbontásban.
/v1/videos/edits — Egy meglévő videót szerkeszt, amelyet egy video objektumban adsz meg (egy .mp4 fájl URL-címe vagy egy file_id).
/v1/videos/extensions — Egy videót új, 2 és 10 másodperc közötti szegmenssel hosszabbít meg.
Akárcsak a képeknél, a videók árazása kötegelt módban is a szokásos díjszabás szerint alakul. A kép- és videoeredmények aláírt URL-címekként érkeznek vissza, amelyek egy óra múlva lejárnak.
Végpontok keverése egy kötegben
Egy JSONL-fájlban minden sor a url mezőben nevezi meg a saját végpontját:
{"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"}}
Így ugyanabban a kötegben generálhatod a termékismertetőidet és a hozzájuk tartozó vizuális elemeket is.
A megfelelő végpont kiválasztása
- Responses: az alapértelmezett választás; elengedhetetlen, ha szerveroldali eszközökre, strukturált kimenetekre vagy a legújabb funkciókra van szükséged
- Chat Completions: folytonosságot biztosít a már Chat Completions formátumban írt kódok számára, és semmi mást
- Képek és videók: vizuális elemek sorozatos előállítására szolgálnak, szem előtt tartva, hogy ezekre nem jár kedvezmény
Főbb megállapítások
- Hét végpont elfogadott: kettő szöveghez, kettő képekhez, három videókhoz
- A Responses az ajánlott végpont; a Chat Completions az xAI-nál elavult végpontnak számít
- Csak a jogosult szöveges modellek tokenjei élvezik a 20%-os kedvezményt
- Minden JSONL-sor
urlmezője határozza meg a célvégpontot, és a végpontok keverhetők egy kötegen belül - A kép- és videoeredmények aláírt URL-címek, amelyek egy óráig érvényesek