Премини към основното съдържание
Български— Изберете език
Меню

Крайни точки, поддържани в партиди

Урок 3 от 12 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Седем крайни точки, един работен поток
  2. Текстови крайни точки
  3. Крайни точки за изображения
  4. Крайни точки за видео
  5. Смесване на крайни точки в една партида
  6. Избор на правилната крайна точка
  7. Ключови изводи

Обновено на 2 ноември 2026 г. въз основа на документацията на xAI: отстъпката за партиди е 20% за допустимите текстови модели (не 50%), примерите следват REST API и официалния xai-sdk (client.batch.*; Batch API на xAI не използва формата на OpenAI, следователно SDK на OpenAI не се прилага), а Responses API има предимство пред Chat Completions, който е остаряла крайна точка в xAI. Източници: Batch API · REST справка · Цени за партиди.

Седем крайни точки, един работен поток

Batch API не се ограничава само до генериране на текст. Той приема седем крайни точки, обхващащи текст, изображения и видео, като можете да ги смесвате в една единствена партида, за да изградите пълни многомодови конвейери с една операция.

Текстови крайни точки

/v1/responses — Responses API, препоръчван от xAI. Той Ви осигурява достъп до сървърни инструменти (търсене в уеб, търсене в X, изпълнение на код, MCP), извикване на функции и структурирани изходи, като получава новите функции пръв.

/v1/chat/completions — Оригиналната крайна точка за завършване във формата на OpenAI. xAI я запазва като остаряла: все още е полезна за съществуващ код, написан спрямо нея, но за нов конвейер е по-добре да започнете с Responses.

За допустимите модели отстъпката от 20% за партиди важи и за двете крайни точки, за всички видове токени.

Крайни точки за изображения

/v1/images/generations — Генерира изображения от подкана (prompt). Параметрите, които ще използвате, са aspect_ratio (например "16:9"), resolution ("1k", "1.5k" или "2k"), n за броя изображения и response_format ("url" или "b64_json").

/v1/images/edits — Редактира съществуващо изображение, посочено чрез обект image, съдържащ url (публичен адрес или данни, кодирани в base64) или file_id на качен файл. Полезно е за изпълнение на трансформации последователно върху визуален каталог.

Изображенията се таксуват по стандартния тарифен план без отстъпка за партиди: тук стойността на пакетирането е оперативна, а не финансова.

Крайни точки за видео

/v1/videos/generations (или /v1/videos) — Генерира видеоклипове от подкана с продължителност от 1 до 15 секунди (duration, по подразбиране 8), с резолюция 480p, 720p или 1080p.

/v1/videos/edits — Редактира съществуващо видео, предадено в обект video (URL адрес на .mp4 файл или file_id).

/v1/videos/extensions — Разширява видеоклип с нов сегмент от 2 до 10 секунди.

Както при изображенията, ценообразуването за видео остава по стандартния тарифен план в режим на партида. Резултатите от изображенията и видеоклиповете се връщат като подписани URL адреси, които изтичат след един час.

Смесване на крайни точки в една партида

Във файл във формат JSONL всеки ред посочва своята крайна точка в полето 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"}}

По този начин можете да генерирате описанията на продуктите си и съответните визуализации в една и съща партида.

Избор на правилната крайна точка

  • Responses: изборът по подразбиране, необходим веднага щом имате нужда от сървърни инструменти, структурирани изходи или най-новите функции.
  • Chat Completions: осигурява приемственост за код, вече написан във формата на Chat Completions, и нищо повече.
  • Изображения и видео: за серийно производство на визуализации, като имате предвид, че те не получават отстъпка.

Ключови изводи

  • Приети са седем крайни точки: две за текст, две за изображения и три за видео.
  • Responses е препоръчителната крайна точка; Chat Completions е остаряла крайна точка в xAI.
  • Само токените за допустими текстови модели получават отстъпка от 20%.
  • Полето url на всеки ред в JSONL определя целевата крайна точка, като крайните точки могат да се смесват в рамките на една партида.
  • Резултатите от изображения и видео са подписани URL адреси, валидни за един час.