Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Partiides toetatud lõpp-punktid

Õppetund 3 / 12 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Seitse lõpp-punkti, üks töövoog
  2. Teksti lõpp-punktid
  3. Piltide lõpp-punktid
  4. Video lõpp-punktid
  5. Lõpp-punktide segamine partis
  6. Õige lõpp-punkti valimine
  7. Peamised punktid

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 url määrab sihtlõpp-punkti ja lõpp-punkte saab partis segada
  • Pildi- ja videotulemused on allkirjastatud URL-id, mis kehtivad ühe tunni