Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Kötegelt műveletekben támogatott végpontok

3. lecke 12 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Hét végpont, egyetlen munkafolyamat
  2. Szöveges végpontok
  3. Képes végpontok
  4. Videós végpontok
  5. Végpontok keverése egy kötegben
  6. A megfelelő végpont kiválasztása
  7. Főbb megállapítások

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 url mező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