Krajnje točke podržane u serijama
Na ovoj stranici
Ažurirano 2. studenoga 2026., na temelju dokumentacije tvrtke xAI: popust za serijsku obradu iznosi 20 % na kvalificirane tekstualne modele (ne 50 %), primjeri slijede REST API i službeni
xai-sdk(client.batch.*; xAI-jev Batch API ne koristi OpenAI-jev format, stoga se OpenAI SDK ne primjenjuje), a Responses API ima prednost nad Chat Completions, koji je kod xAI-ja zastarjela krajnja točka. Izvori: Batch API · REST referenca · Cjenik za serije.
Sedam krajnjih točaka, jedan tijek rada
Batch API nije ograničen samo na generiranje teksta. Prihvaća sedam krajnjih točaka koje pokrivaju tekst, slike i videozapise, a možeš ih miješati unutar jedne serije kako bi izgradio/la kompletne multimodalne cjevovode u jednoj operaciji.
Tekstualne krajnje točke
/v1/responses — Responses API, koji xAI preporučuje. Omogućuje ti pristup alatima na strani poslužitelja (pretraživanje weba, pretraživanje platforme X, izvršavanje koda, MCP), pozivanju funkcija i strukturiranim izlazima, a prvi dobiva nove značajke.
/v1/chat/completions — Izvorna krajnja točka za dovršavanje, u OpenAI-jevom formatu. xAI je zadržava kao zastarjelu krajnju točku: i dalje je korisna za postojeći kod napisan za nju, ali je za novi cjevovod bolje započeti s Responsesom.
Na kvalificiranim modelima, popust od 20 % za serijsku obradu vrijedi za obje krajnje točke, za sve vrste tokena.
Krajnje točke za slike
/v1/images/generations — Generira slike na temelju upita. Parametri koje ćeš koristiti su aspect_ratio (na primjer "16:9"), resolution ("1k", "1.5k" ili "2k"), n za broj slika i response_format ("url" ili "b64_json").
/v1/images/edits — Uređuje postojeću sliku, specificiranu putem objekta image koji sadrži url (javna adresa ili podaci kodirani u base64) ili file_id prenesene datoteke. Korisno za serijsko pokretanje transformacija kroz vizualni katalog.
Slike se naplaćuju po standardnoj tarifi, bez popusta za serije: ovdje je vrijednost serijske obrade operativna, a ne financijska.
Krajnje točke za videozapise
/v1/videos/generations (ili /v1/videos) — Generira videozapise na temelju upita, u trajanju od 1 do 15 sekundi (duration, zadano 8), u razlučivosti 480p, 720p ili 1080p.
/v1/videos/edits — Uređuje postojeći videozapis, proslijeđen u objektu video (URL .mp4 datoteke ili file_id).
/v1/videos/extensions — Proširuje videozapis novim segmentom od 2 do 10 sekundi.
Kao i kod slika, cijene videozapisa ostaju po standardnoj tarifi u načinu serijske obrade. Rezultati za slike i videozapise vraćaju se kao potpisani URL-ovi koji istječu nakon jednog sata.
Miješanje krajnjih točaka u seriji
U JSONL datoteci svaki redak navodi svoju krajnju točku u polju 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"}}
Na ovaj način možeš generirati opise svojih proizvoda i njihove vizuale u istoj seriji.
Odabir prave krajnje točke
- Responses: zadani izbor, neophodan čim su ti potrebni alati na strani poslužitelja, strukturirani izlazi ili najnovije značajke
- Chat Completions: kontinuitet za kod već napisan u formatu Chat Completions i ništa više
- Slike i video: za serijsku proizvodnju vizuala, imajući na umu da za njih nema popusta
Ključne točke
- Prihvaćeno je sedam krajnjih točaka: dvije za tekst, dvije za slike, tri za video
- Responses je preporučena krajnja točka; Chat Completions je zastarjela krajnja točka kod xAI-ja
- Samo tokeni na kvalificiranim tekstualnim modelima ostvaruju popust od 20 %
- Polje
urlsvakog retka u JSONL-u određuje ciljanu krajnju točku, a krajnje se točke mogu miješati unutar serije - Rezultati za slike i videozapise su potpisani URL-ovi valjani jedan sat