Endpointuri acceptate în loturi
Pe această pagină
Actualizat pe 2 noiembrie 2026, pe baza documentației xAI: reducerea pentru loturi este de 20% la modelele de text eligibile (nu 50%), exemplele respectă API-ul REST și SDK-ul oficial
xai-sdk(client.batch.*; API-ul Batch al xAI nu folosește formatul OpenAI, deci SDK-ul OpenAI nu se aplică), iar API-ul Responses are prioritate față de Chat Completions, un endpoint moștenit la xAI. Surse: Batch API · Referință REST · Prețuri Batch.
Șapte endpointuri, un singur flux de lucru
API-ul Batch nu se limitează la generarea de text. Acceptă șapte endpointuri care acoperă textul, imaginile și videoclipurile, iar dumneavoastră le puteți combina într-un singur lot pentru a construi pipeline-uri multimodale complete într-o singură operațiune.
Endpointuri pentru text
/v1/responses — API-ul Responses, cel recomandat de xAI. Vă oferă acces la instrumente lato-server (căutare web, căutare X, executare de cod, MCP), apeluri de funcții și ieșiri structurate, fiind primul care primește noile funcționalități.
/v1/chat/completions — Endpointul original de completare, în formatul OpenAI. xAI îl menține ca endpoint moștenit: rămâne util pentru codul existent scris pentru acesta, dar un nou pipeline ar trebui să înceapă cu Responses.
La modelele eligibile, reducerea de 20% pentru loturi se aplică ambelor endpointuri, pentru toate tipurile de tokeni.
Endpointuri pentru imagini
/v1/images/generations — Generează imagini pe baza unui prompt. Parametrii pe care îi veți utiliza sunt aspect_ratio (de exemplu "16:9"), resolution ("1k", "1.5k" sau "2k"), n pentru numărul de imagini și response_format ("url" sau "b64_json").
/v1/images/edits — Editează o imagine existentă, specificată printr-un obiect image care conține un url (o adresă publică sau date codificate base64) sau file_id-ul unui fișier încărcat. Util pentru rularea transformărilor în serie într-un catalog vizual.
Imaginile sunt facturate la tariful standard, fără reducere pentru loturi: aici, valoarea lucrului în lot este operațională, nu financiară.
Endpointuri pentru video
/v1/videos/generations (sau /v1/videos) — Generează videoclipuri pe baza unui prompt, cu o durată de la 1 la 15 secunde (duration, implicit 8), la rezoluțiile 480p, 720p sau 1080p.
/v1/videos/edits — Editează un videoclip existent, transmis într-un obiect video (URL-ul unui fișier .mp4 sau un file_id).
/v1/videos/extensions — Prelungește un videoclip cu un nou segment de 2 până la 10 secunde.
Ca și în cazul imaginilor, prețurile pentru video rămân la tariful standard în modul lot. Rezultatele pentru imagini și video sunt returnate sub formă de URL-uri semnate care expiră după o oră.
Combinarea endpointurilor într-un lot
Într-un fișier JSONL, fiecare linie își numește endpointul în câmpul 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"}}
În acest mod, puteți genera descrierile produselor și elementele lor vizuale în același lot.
Alegerea endpointului potrivit
- Responses: alegerea implicită, esențială imediat ce aveți nevoie de instrumente lato-server, ieșiri structurate sau cele mai noi funcționalități
- Chat Completions: continuitate pentru codul deja scris în formatul Chat Completions și nimic mai mult
- Imagini și video: pentru producerea de elemente vizuale în serie, reținând că acestea nu beneficiază de reducere
Puncte cheie
- Sunt acceptate șapte endpointuri: două pentru text, două pentru imagini, trei pentru video
- Responses este endpointul recomandat; Chat Completions este un endpoint moștenit la xAI
- Doar tokenii de la modelele de text eligibile beneficiază de reducerea de 20%
- Câmpul
urlal fiecărei linii JSONL determină endpointul țintă, iar endpointurile pot fi amestecate într-un lot - Rezultatele pentru imagini și video sunt URL-uri semnate valabile o oră