Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Krajnje točke podržane u serijama

Lekcija 3 od 12 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Sedam krajnjih točaka, jedan tijek rada
  2. Tekstualne krajnje točke
  3. Krajnje točke za slike
  4. Krajnje točke za videozapise
  5. Miješanje krajnjih točaka u seriji
  6. Odabir prave krajnje točke
  7. Ključne točke

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 url svakog 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