Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Beigu punkti, ko atbalsta pakešapstrāde

Nodarbība 3 no 12 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Septiņi beigu punkti, viena darbplūsma
  2. Teksta beigu punkti
  3. Attēlu beigu punkti
  4. Video beigu punkti
  5. Beigu punktu jaukšana vienā paketē
  6. Pareizā beigu punkta izvēle
  7. Galvenās atziņas

Atjaunināts 2026. gada 2. novembrī, pamatojoties uz xAI dokumentāciju: atlaide pakešapstrādei ir 20 % atbilstošajiem teksta modeļiem (nevis 50 %), piemēri seko REST API un oficiālajam xai-sdk (client.batch.*; xAI pakešapstrādes API neizmanto OpenAI formātu, tāpēc OpenAI SDK nav piemērojams), un Responses API ir prioritārs pār Chat Completions, kas xAI ir novecojis beigu punkts. Avoti: Batch API · REST atsauce · Pakešapstrādes cenas.

Septiņi beigu punkti, viena darbplūsma

Pakešapstrādes API neaprobežojas tikai ar teksta ģenerēšanu. Tas pieņem septiņus beigu punktus, kas aptver tekstu, attēlus un video, un tu vari tos jaukt vienā paketē, lai vienā operācijā izveidotu pilnvērtīgas multimodālas cauruļvadu sistēmas.

Teksta beigu punkti

/v1/responses — Responses API, ko xAI iesaka. Tas nodrošina piekļuvi servera puses rīkiem (meklēšana tīmeklī, meklēšana platformā X, koda izpilde, MCP), funkciju izsaukumiem un strukturētām izvades datnēm, un tas pirmais saņem jaunās funkcijas.

/v1/chat/completions — Sākotnējais pabeigšanas beigu punkts OpenAI formātā. xAI to uztur kā novecojušu beigu punktu: tas joprojām ir noderīgs esošajam kodam, kas rakstīts tieši tam, taču jaunam cauruļvadam ir labāk sākt ar Responses.

Atbilstošajiem modeļiem 20 % atlaide pakešapstrādei attiecas uz abiem beigu punktiem visiem tokena veidiem.

Attēlu beigu punkti

/v1/images/generations — Ģenerē attēlus no uzvednes. Parametri, kurus izmantosi, ir aspect_ratio (piemēram, "16:9"), resolution ("1k", "1.5k" vai "2k"), n attēlu skaitam un response_format ("url" vai "b64_json").

/v1/images/edits — Rediģē esošu attēlu, kas norādīts image objektā, kurš satur url (publisku adresi vai base64 kodētus datus) vai augšupielādētas datnes file_id. Noderīgi, lai virknes režīmā veiktu transformācijas vizuālajā katalogā.

Par attēliem tiek iekasēta standarta maksa bez atlaides pakešapstrādei: šeit pakešapstrādes vērtība ir operacionāla, nevis finansiāla.

Video beigu punkti

/v1/videos/generations (vai /v1/videos) — Ģenerē video no uzvednes, kuru garums ir no 1 līdz 15 sekundēm (duration, pēc noklusējuma 8), izšķirtspējā 480p, 720p vai 1080p.

/v1/videos/edits — Rediģē esošu video, kas padots video objektā (.mp4 datnes URL vai file_id).

/v1/videos/extensions — Paplašina video, pievienojot tam jaunu segmentu no 2 līdz 10 sekundēm.

Tāpat kā attēlu gadījumā, video cenas pakešapstrādes režīmā paliek standarta līmenī. Attēlu un video rezultāti tiek atgriezti kā parakstīti URL, kas zaudē spēku pēc vienas stundas.

Beigu punktu jaukšana vienā paketē

JSONL datnē katra rinda norāda savu beigu punktu laukā 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"}}

Tādā veidā tu vari vienā paketē ģenerēt savu produktu aprakstus un tiem atbilstošos vizuālos materiālus.

Pareizā beigu punkta izvēle

  • Responses: noklusējuma izvēle, kas ir obligāta, tiklīdz tev ir nepieciešami servera puses rīki, strukturētas izvades datnes vai jaunākās funkcijas.
  • Chat Completions: nepārtrauktība kodam, kas jau ir rakstīts Chat Completions formātā, un nekas vairāk.
  • Attēli un video: vizuālo materiālu sērijveida ražošanai, ņemot vērā, ka tiem netiek piemērota atlaide.

Galvenās atziņas

  • Tiek pieņemti septiņi beigu punkti: divi tekstam, divi attēliem, trīs video.
  • Responses ir ieteicamais beigu punkts; Chat Completions xAI ir novecojis beigu punkts.
  • 20 % atlaide attiecas tikai uz tokeniem atbilstošajos teksta modeļos.
  • Katras JSONL rindas lauks url nosaka mērķa beigu punktu, un vienā paketē var jaukt dažādus beigu punktus.
  • Attēlu un video rezultāti ir parakstīti URL, kas ir derīgi vienu stundu.