Päätepisteet, joita erät tukevat
Tällä sivulla
Päivitetty 2. marraskuuta 2026 xAI:n dokumentaation perusteella: eräalennus on 20 % tukikelpoisissa tekstimalleissa (ei 50 %), esimerkit noudattavat REST API:a ja virallista
xai-sdk:ta (client.batch.*; xAI:n Batch API ei käytä OpenAI:n formaattia, joten OpenAI SDK ei päde), ja Responses API on ensisijainen Chat Completionsiin nähden, joka on xAI:lla vanhentunut päätepiste. Lähteet: Batch API · REST-viite · Erähinnoittelu.
Seitsemän päätepistettä, yksi työnkulku
Batch API ei rajoitu pelkkään tekstin tuottamiseen. Se hyväksyy seitsemän päätepistettä, jotka kattavat tekstin, kuvat ja videot, ja voit yhdistellä niitä samassa erässä rakentaaksesi kokonaisia multimodaalisia putkia yhdessä operaatiossa.
Tekstipäätepisteet
/v1/responses — Responses API, jonka xAI suosittelee. Se antaa sinulle pääsyn palvelinpuolen työkaluihin (web-haku, X-haku, koodin suoritus, MCP), funktiokutsuihin ja jäsenneltyihin tulosteisiin, ja se saa uudet ominaisuudet ensimmäisenä.
/v1/chat/completions — Alkuperäinen täydennyspäätepiste OpenAI:n formaatissa. xAI pitää sitä vanhentuneena päätepisteenä: se on edelleen hyödyllinen olemassa olevalle koodille, joka on kirjoitettu sitä varten, mutta uuden putken kannattaa aloittaa Responsesilla.
Tukikelpoisissa malleissa 20 %:n eräalennus koskee molempia päätepisteitä kaikkien token-tyyppien osalta.
Kuvapäätepisteet
/v1/images/generations — Tuottaa kuvia kehotteesta. Käyttämiäsi parametreja ovat aspect_ratio (esimerkiksi "16:9"), resolution ("1k", "1.5k" tai "2k"), n kuvien määrälle ja response_format ("url" tai "b64_json").
/v1/images/edits — Muokkaa olemassa olevaa kuvaa, joka määritetään image-objektilla sisältäen joko url:n (julkinen osoite tai base64-koodattu data) tai ladatun tiedoston file_id:n. Hyödyllinen suoritettaessa muunnoksia sarjana visuaalisessa luettelossa.
Kuvista laskutetaan normaalin hinnaston mukaan ilman eräalennusta: tässä erätyöstelyn arvo on operatiivinen, ei taloudellinen.
Videopäätepisteet
/v1/videos/generations (tai /v1/videos) — Tuottaa videoita kehotteesta, pituudeltaan 1–15 sekuntia (duration, oletus 8), resoluutioina 480p, 720p tai 1080p.
/v1/videos/edits — Muokkaa olemassa olevaa videota, joka välitetään video-objektissa (.mp4-tiedoston URL tai file_id).
/v1/videos/extensions — Laajentaa videota uudella 2–10 sekunnin segmentillä.
Kuten kuvienkin kohdalla, videoiden hinnoittelu pysyy erätilassa normaalin hinnaston mukaisena. Kuva- ja videotulokset palautuvat allekirjoitettuina URL-osoitteina, jotka vanhenevat tunnin kuluttua.
Päätepisteiden yhdistäminen erässä
JSONL-tiedostossa jokainen rivi nimeää päätepisteensä url-kentässä:
{"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"}}
Tällä tavalla voit tuottaa tuotekuvauksesi ja niihin liittyvät visuaalit samassa erässä.
Oikean päätepisteen valinta
- Responses: oletusvalinta, välttämätön heti kun tarvitset palvelinpuolen työkaluja, jäsenneltyjä tulosteita tai uusimpia ominaisuuksia
- Chat Completions: jatkuvuutta koodille, joka on jo kirjoitettu Chat Completions -formaatissa, eikä muuta
- Kuvat ja videot: visuaalien tuottamiseen sarjoissa, pitäen mielessä, että niille ei myönnetä alennusta
Keskeiset asiat
- Seitsemän päätepistettä hyväksytään: kaksi tekstille, kaksi kuville, kolme videolle
- Responses on suositeltu päätepiste; Chat Completions on xAI:lla vanhentunut päätepiste
- Vain tukikelpoisten tekstimallejen tokenit saavat 20 %:n alennuksen
- Jokaisen JSONL-rivin
url-kenttä määrittää kohdepäätepisteen, ja päätepisteitä voi sekoittaa erän sisällä - Kuva- ja videotulokset ovat allekirjoitettuja URL-osoitteita, jotka ovat voimassa yhden tunnin