Крайни точки, поддържани в партиди
На тази страница
Обновено на 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 адреси, валидни за един час.