Partiides toetatud lõpp-punktid
Sellel lehel
Uuendatud 2. novembril 2026, lähtudes xAI dokumentatsioonist: partiisoodustus on õigustatud tekst mudelite puhul 20% (mitte 50%), näited järgivad REST API-t ja ametlikku
xai-sdk-d (client.batch.*; xAI parti API ei kasuta OpenAI vormingut, seega OpenAI SDK ei kehti) ning Responses API-l on eelis Chat Completionsi ees, mis on xAI-s iganenud lõpp-punkt. Allikad: Batch API · REST viide · Parti hinnakiri.
Seitse lõpp-punkti, üks töövoog
Parti API ei piirdu ainult teksti genereerimisega. See aktsepteerib seitset lõpp-punkti, hõlmates teksti, pilte ja videoid, ning saad neid ühes partis segada, et luua ühe operatsiooniga terviklikke multimeedia torustikke.
Teksti lõpp-punktid
/v1/responses — Responses API, mida xAI soovitab. See annab juurdepääsu serveripoolsetele tööriistadele (veebiotsing, X-i otsing, koodi täitmine, MCP), funktsioonide kutsumisele ja struktureeritud väljunditele ning saab uusi funktsioone esimesena.
/v1/chat/completions — Algne lõpetamise lõpp-punkt OpenAI vormingus. xAI säilitab seda iganenud lõpp-punktina: see on endiselt kasulik olemasoleva koodi jaoks, mis on selle vastu kirjutatud, kuid uut torustikku on parem alustada Responsesiga.
Õigustatud mudelite puhul kehtib 20% partiisoodustus mõlema lõpp-punkti ja kõikide tokenite tüüpide suhtes.
Piltide lõpp-punktid
/v1/images/generations — Genereerib pilte vihje põhjal. Parameetrid, mida kasutad, on aspect_ratio (näiteks "16:9"), resolution ("1k", "1.5k" või "2k"), n piltide arvu jaoks ja response_format ("url" või "b64_json").
/v1/images/edits — Muudab olemasolevat pilti, mida täpsustab image objekt, sisaldades kas url-i (avalik aadress või base64-kodeeritud andmed) või üles laaditud faili file_id-d. Kasulik teisenduste jada käivitamiseks visuaalses kataloogis.
Pilte arveldatakse tavahinnaga ilma partiisoodustuseta: siin seisneb partii kasu operatiivsuses, mitte rahalises kokkuhoius.
Video lõpp-punktid
/v1/videos/generations (või /v1/videos) — Genereerib videoid vihje põhjal, pikkusega 1 kuni 15 sekundit (duration, vaikimisi 8), resolutsiooniga 480p, 720p või 1080p.
/v1/videos/edits — Muudab olemasolevat videot, mis edastatakse video objektis (.mp4 faili URL või file_id).
/v1/videos/extensions — Pikendab videot uue 2–10-sekundise lõiguga.
Nagu piltide puhul, jääb videote hinnakiri partiirežiimis samuti tavapäraseks. Pildi- ja videotulemused saadetakse tagasi allkirjastatud URL-idena, mis aeguvad tunni pärast.
Lõpp-punktide segamine partis
JSONL-failis määrab iga rida oma lõpp-punkti väljal 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"}}
Sel viisil saad genereerida oma tootekirjeldused ja nendega seotud visuaalid samas partis.
Õige lõpp-punkti valimine
- Responses: vaikimisi valik, hädavajalik niipea, kui vajad serveripoolseid tööriistu, struktureeritud väljundeid või uusimaid funktsioone
- Chat Completions: järjepidevus juba Chat Completionsi vormingus kirjutatud koodi jaoks ja mitte midagi enamat
- Pildid ja video: visuaalide seeriatena tootmiseks, pidades silmas, et need ei saa soodustust
Peamised punktid
- Aktsepteeritakse seitset lõpp-punkti: kaks teksti, kaks piltide ja kolm video jaoks
- Responses on soovitatav lõpp-punkt; Chat Completions on xAI-s iganenud lõpp-punkt
- Ainult õigustatud tekst mudelite tokenid saavad 20% soodustust
- Iga JSONL-reaväli
urlmäärab sihtlõpp-punkti ja lõpp-punkte saab partis segada - Pildi- ja videotulemused on allkirjastatud URL-id, mis kehtivad ühe tunni