Končne točke, podprte v paketih
Na tej strani
Posodobljeno 2. novembra 2026 na podlagi dokumentacije xAI: popust za pakete znaša 20 % za upravičene besedilne modele (ne 50 %), primeri sledijo REST API-ju in uradnemu
xai-sdk(client.batch.*; xAI-jev Batch API ne uporablja formata OpenAI, zato SDK OpenAI ne velja), API Responses pa ima prednost pred Chat Completions, ki je pri xAI zastarela končna točka. Viri: Batch API · Referenca REST · Cenik za pakete.
Sedem končnih točk, en delovni tok
Batch API ni omejen le na generiranje besedila. Sprejme sedem končnih točk, ki pokrivajo besedilo, slike in videoposnetke, ter ti omogoča njihovo mešanje v enem samem paketu za izgradnjo celovitih večmodalnih cevovodov v eni operaciji.
Besedilne končne točke
/v1/responses — API Responses, ki ga xAI priporoča. Omogoča dostop do orodij na strani strežnika (spletno iskanje, iskanje po X, izvajanje kode, MCP), klicanje funkcij in strukturirane izhode, nove funkcije pa prejme prvi.
/v1/chat/completions — Izvirna končna točka za dopolnjevanje v formatu OpenAI. xAI jo ohranja kot zastarelo končno točko: še vedno je uporabna za obstoječo kodo, napisano zanjo, vendar je za nov cevovod bolje začeti z Responses.
Pri upravičenih modelih se 20-odstotni popust za pakete uporablja za obe končni točki in za vse vrste žetonov.
Končne točke za slike
/v1/images/generations — Generira slike na podlagi poziva. Parametri, ki jih boš uporabil, so aspect_ratio (na primer "16:9"), resolution ("1k", "1.5k" ali "2k"), n za število slik in response_format ("url" ali "b64_json").
/v1/images/edits — Uredi obstoječo sliko, določeno z objektom image, ki vsebuje url (javni naslov ali podatki, kodirani v base64) ali file_id naložene datoteke. Uporabno za zaporedno izvajanje transformacij v vizualnem katalogu.
Slike se zaračunavajo po standardni tarifi brez popusta za pakete: tu je vrednost paketne obdelave operativna, ne finančna.
Končne točke za videoposnetke
/v1/videos/generations (ali /v1/videos) — Generira videoposnetke na podlagi poziva, dolge od 1 do 15 sekund (duration, privzeto 8), v ločljivosti 480p, 720p ali 1080p.
/v1/videos/edits — Uredi obstoječi videoposnetek, podan v objektu video (URL datoteke .mp4 ali file_id).
/v1/videos/extensions — Razširi videoposnetek z novim segmentom v trajanju od 2 do 10 sekund.
Tako kot pri slikah tudi pri videoposnetkih cena v načinu paketne obdelave ostane standardna. Rezultati za slike in videoposnetke so vrnjeni kot podpisani URL-ji, ki potečejo po eni uri.
Mešanje končnih točk v paketu
V datoteki JSONL vsaka vrstica v polju url imenuje svojo končno točko:
{"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"}}
Na ta način lahko v istem paketu generiraš opise izdelkov in njihove vizuale.
Izbira prave končne točke
- Responses: privzeta izbira, bistvena takoj, ko potrebuješ orodja na strani strežnika, strukturirane izhode ali najnovejše funkcije
- Chat Completions: kontinuiteta za kodo, že napisano v formatu Chat Completions, in nič več
- Slike in videoposnetki: za serijsko izdelavo vizualov, ob upoštevanju, da zanje ni popusta
Ključne ugotovitve
- Sprejetih je sedem končnih točk: dve za besedilo, dve za slike in tri za videoposnetke
- Responses je priporočena končna točka; Chat Completions je pri xAI zastarela končna točka
- 20-odstotni popust velja le za žetone na upravičenih besedilnih modelih
- Polje
urlvsake vrstice JSONL določa ciljno končno točko, končne točke pa se lahko v paketu mešajo - Rezultati za slike in videoposnetke so podpisani URL-ji, veljavni eno uro