Salt la conținutul principal
Română— Alege o limbă
Meniu

Endpointuri acceptate în loturi

Lecția 3 din 12 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Șapte endpointuri, un singur flux de lucru
  2. Endpointuri pentru text
  3. Endpointuri pentru imagini
  4. Endpointuri pentru video
  5. Combinarea endpointurilor într-un lot
  6. Alegerea endpointului potrivit
  7. Puncte cheie

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 url al 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ă