Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pabaigos taškai, palaikomi paketiniame režimu

Paskaita 3 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Septyni pabaigos taškai, viena darbo eiga
  2. Teksto pabaigos taškai
  3. Vaizdų pabaigos taškai
  4. Vaizdo įrašų pabaigos taškai
  5. Pabaigos taškų maišymas pakete
  6. Tinkamo pabaigos taško pasirinkimas
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. pagal xAI dokumentaciją: paketinė nuolaida eligible teksto modeliams yra 20 % (ne 50 %), pavyzdžiai atitinka REST API ir oficialųjį xai-sdk (client.batch.*; xAI paketinis API nenaudoja OpenAI formato, todėl OpenAI SDK netinka), o Responses API turi viršenybę prieš Chat Completions, kuris xAI sistemoje yra pasenusi pabaiga. Šaltiniai: Batch API · REST nuoroda · Paketinių kainodara.

Septyni pabaigos taškai, viena darbo eiga

Paketinis API nėra skirtas tik teksto generavimui. Jis priima septynis pabaigos taškus, apimančius tekstą, vaizdus ir vaizdo įrašus, ir gali juos maišyti viename pakete, kad viena operacija sukurtumėte pilnas daugiamodes darbo eigas.

Teksto pabaigos taškai

/v1/responses — Responses API, kurį rekomenduoja xAI. Jis suteikia prieigą prie serverio pusės įrankių (interneto paieška, X paieška, kodo vykdymas, MCP), funkcijų kvietimo ir struktūrizuotų išvesčių, be to, naujos funkcijos čia atsiranda pirmiausia.

/v1/chat/completions — Originalus užbaigimo pabaigos taškas, naudojantis OpenAI formatu. xAI jį paliko kaip pasenusį: jis vis dar naudingas esamam kodui, parašytam specialiai jam, tačiau naują darbo eigą geriau pradėti nuo Responses.

Eligible modeliams 20 % paketinė nuolaida taikoma abiem šiems pabaigos taškams, visiems žetonų tipams.

Vaizdų pabaigos taškai

/v1/images/generations — Generuoja vaizdus iš užuominos. Naudosi šiuos parametrus: aspect_ratio (pavyzdžiui, "16:9"), resolution ("1k", "1.5k" arba "2k"), n vaizdų skaičiui ir response_format ("url" arba "b64_json").

/v1/images/edits — Redaguoja esamą vaizdą, nurodytą image objekte, kuriame yra url (viešas adresas arba base64 koduoti duomenys) arba įkeltos failo file_id. Naudinga vykdant transformacijas serijomis per vizualinį katalogą.

Už vaizdus mokama standartiniu tarifu, be paketinės nuolaidos: čia paketavimo vertė yra operacinė, o ne finansinė.

Vaizdo įrašų pabaigos taškai

/v1/videos/generations (arba /v1/videos) — Generuoja vaizdo įrašus iš užuominos, kurių trukmė nuo 1 iki 15 sekundžių (duration, pagal nutylėjimą 8), 480p, 720p arba 1080p raiška.

/v1/videos/edits — Redaguoja esamą vaizdo įrašą, perduodamą video objekte (.mp4 failo URL arba file_id).

/v1/videos/extensions — Pratęsia vaizdo įrašą nauju 2–10 sekundžių segmentu.

Kaip ir vaizdų atveju, vaizdo įrašų kainodara paketiniu režimu išlieka standartinė. Vaizdų ir vaizdo įrašų rezultatai grąžinami kaip pasirašyti URL, kurie galioja vieną valandą.

Pabaigos taškų maišymas pakete

JSONL faile kiekviena eilutė nurodo savo pabaigos tašką lauke 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"}}

Taip viename pakete gali generuoti savo produktų aprašymus ir jiems skirtus vizualus.

Tinkamo pabaigos taško pasirinkimas

  • Responses: numatytasis pasirinkimas, būtinas, kai tik reikia serverio pusės įrankių, struktūrizuotų išvesčių arba naujausių funkcijų.
  • Chat Completions: tęstinumas kodui, jau parašytam Chat Completions formatu, ir niekas daugiau.
  • Vaizdai ir vaizdo įrašai: skirti vizualų kūrimui serijomis, atmintyje turint, kad jiems netaikoma nuolaida.

Svarbiausi punktai

  • Priimami septyni pabaigos taškai: du tekstui, du vaizdams, trys vaizdo įrašams.
  • Responses yra rekomenduojamas pabaigos taškas; Chat Completions xAI sistemoje yra pasenęs.
  • 20 % nuolaida taikoma tik eligible teksto modelių žetonams.
  • Kiekvienos JSONL eilutės laukas url nustato tikslinį pabaigos tašką, o pakete pabaigos taškai gali būti maišomi.
  • Vaizdų ir vaizdo įrašų rezultatai yra pasirašyti URL, galiojantys vieną valandą.