Съотношения на страните, резолюции и управление на разходите
На тази страница
Обновено на 3 ноември 2026 г. въз основа на документацията за видео на xAI: API приема девет съотношения на страните (включително
21:9и5:2) и три резолюции, като1080pзависи от модела; трите видео модела имат собствено ценообразуване; а параметърътsizeс неговите пикселни размери, представен в по-старата версия, липсва в справочника на API. Източници: Video Generation · Videos API · Pricing.
Оптимизирайте генерирането на видеоклипове
Знанието как да напишете подкана не е достатъчно, за да преминете към производство. Два фактора определят остатъка: техническото оформяне на изходите и контролът на разходите. Студио, което генерира двеста клипа на месец без стратегия за прототипиране, плаща няколко пъти необходимата цена, а екип, който открива в края на проекта, че форматът му не съответства на канала за разпространение, трябва да започне отначало. Този урок обхваща и двете точки заедно, защото те се информират взаимно.
Изберете правилното съотношение на страните
Параметърът aspect_ratio задава пропорциите на генерираното видео. Приемат се девет стойности, като всяка отговаря на конкретна дестинация за разпространение.
| Съотношение | Пропорции | Основна употреба |
|---|---|---|
16:9 | Широкоекранен пейзаж | YouTube, презентации, уебсайтове |
9:16 | Портрет | TikTok, Stories, Reels |
1:1 | Квадрат | Публикации в социалните мрежи, миниатюри |
4:3 | Класически пейзаж | Документи, слайдове |
3:4 | Класически портрет | Pinterest, плакати |
3:2 | Фото пейзаж | Портфолиа, галерии |
2:3 | Фото портрет | Плакати, корици |
21:9 | Широкоекранно кино | Кинематографични кадри |
5:2 | Банер | Уеб банери, заглавки |
При липса на изричен параметър, API прилага 16:9. Това е разумна стойност по подразбиране за уеб, но се превръща в капан, щом подадете вертикални формати: кампания, предназначена за Reels, трябва да декларира 9:16 при всяка заявка, в противен случай ще получите пейзажни кадри, които ще изискват изрязване, със загуба на композицията, която това предполага. Два режима са освободени от тази настройка: при изображение-към-видео изходът следва съотношението на изходното изображение, а при редактиране – това на изходното видео.
Три резолюции, в зависимост от модела
Параметърът resolution приема три стойности. Стойността по подразбиране, 480p, е предназначена за прегледи и чернови: рендирането е по-бързо, което я прави идеална тестова среда за валидиране на подканата, преди да я стартирате отново с крайното качество. 720p съответства на HD качество, достатъчно за повечето уеб и мобилни употреби. 1080p най-накрая ви предоставя Full HD, но не на всички модели:
| Модел | Максимална резолюция |
|---|---|
grok-imagine-video-1.5 | Native 1080p (720p в reference-to-video) |
grok-imagine-video-1.5-lite | 1080p, чрез мащабиране от 720p |
grok-imagine-video | 720p |
Редактирането не е регулируемо: произведеното видео запазва резолюцията на източника, ограничена до 720p. И няма по-фина настройка от тези стъпки: справочникът на API не предоставя параметър за размер в пиксели. Ако разпространението ви изисква точни размери, изберете най-близкото съотношение и резолюция, след което изрежете при редактиране.
{
"model": "grok-imagine-video-1.5",
"prompt": "Your description",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 5
}
Какво наистина струва производството
Цената се брои за всяка секунда генерирано видео и зависи от модела: $0.020 за grok-imagine-video-1.5-lite, $0.050 за grok-imagine-video и $0.080 за grok-imagine-video-1.5. Прогресията е перфектно линейна, което прави бюджета предвидим.
| Продължителност | 1.5-lite | grok-imagine-video | 1.5 |
|---|---|---|---|
| 1 секунда | $0.02 | $0.05 | $0.08 |
| 3 секунди | $0.06 | $0.15 | $0.24 |
| 5 секунди | $0.10 | $0.25 | $0.40 |
| 8 секунди (по подразбиране) | $0.16 | $0.40 | $0.64 |
| 10 секунди | $0.20 | $0.50 | $0.80 |
| 15 секунди | $0.30 | $0.75 | $1.20 |
Към 3 ноември 2026 г. страницата Models на xAI показва единична цена за секунда за всеки модел, без разлика за резолюцията, докато страницата Video Overview се позовава на цени „на резолюция“: проверете таблицата, преди да ангажирате голяма партида.
Първият лост за оптимизация е изборът на модел. xAI препоръчва grok-imagine-video-1.5-lite, четири пъти по-евтин от версия 1.5, за обикновени видеоклипове, и grok-imagine-video-1.5, когато имате нужда от референтни изображения, гласове, наложени изображения или native 1080p; редактирането и разширяването междувременно работят само с grok-imagine-video. Вторият лост е броят на опитите. Прототипирайте системно кратко: валидирайте посоката на движение за две или три секунди, преди да се ангажирате с генериране от десет или петнадесет секунди. Прецизирайте подканата, докато стане правилна от първия опит, тъй като всяко регенериране се заплаща на пълна цена. Стартирайте тези опити в 480p: показаната цена не се променя, но съкратеното време за генериране ви позволява да итерирате по-бързо. И имайте предвид ограничението на скоростта, когато планирате партида.
Това разсъждение се изчислява лесно. За проект от двадесет петсекундни видеоклипа с grok-imagine-video, суровото производство възлиза на 20 × $0.25, или $5.00 ($2.00 с lite версията, $8.00 с 1.5). Приемете две средни итерации на видео и сте на $10.00. Добавете марж за експериментиране от 50% и представяте бюджет от $15.00, който ще се удържи. Това е порядъкът на величината, който да съобщите на клиент, а не теоретичната цена на първото изчисление.
Управление на ограниченията на скоростта (Rate Limits)
Ограниченията на API се броят в заявки в секунда, на модел, и растат с нивото на вашия екип, което само по себе си се определя от вашите кумулативни разходи: на входното ниво видео моделите приемат 10 заявки в секунда, а API отговаря с 429 Too Many Requests отвъд това (Rate limits). При обичайна употреба това ограничение рядко се достига: тъй като генерирането е асинхронно и продължително, прекарвате повече време в чакане, отколкото в подаване. Рискът се появява при масивни партиди, стартирани паралелно, където няколко реда код могат да наситят квотата мигновено. Разпределянето на подаванията е достатъчно, за да останете в рамките.
import asyncio
async def soumettre_lot(prompts, par_seconde=5):
"""Submits generations without exceeding the rate limit."""
for prompt in prompts:
await soumettre_video(prompt) # POST, without waiting for completion
await asyncio.sleep(1 / par_seconde)
За много големи партиди, които могат да изчакат, API Batch предлага друг път: неговите заявки не се броят към ограниченията на скоростта и трите видео модела го приемат (само в определени региони за grok-imagine-video и grok-imagine-video-1.5). Не очаквайте спестявания: отстъпката на Batch се прилага само за текстови модели, а видеото се таксува на стандартния тарифен план. Обработката обикновено се извършва в рамките на 24 часа, без гаранция.
Доставяне на видеото без изтегляне
Последната полезна настройка в производството: параметърът output.upload_url определя подписан URL адрес (S3 или GCS presigned, Azure SAS), към който видеото ще бъде автоматично изпратено чрез HTTP PUT, със заглавка Content-Type: video/mp4, веднага щом бъде генерирано.
{
"model": "grok-imagine-video",
"prompt": "Your description",
"duration": 5,
"output": {
"upload_url": "https://your-storage.com/upload/video.mp4"
}
}
На практика това премахва цяла стъпка от вашия конвейер: няма нужда да изтегляте всеки файл и след това да го качвате във вашето хранилище, видеото пристига директно на местоназначението си. При поток от няколко десетки клипа на ден, това означава толкова по-малко код за трансфер и обработка на грешки за поддържане.
Цени, записани на 3 ноември 2026 г. — цените се променят редовно: преди всяко изчисление на бюджета, проверете текущата таблица на официалната страница за модели и цени на xAI.
Ключови изводи
- Налични са девет съотношения на страните,
16:9по подразбиране; при изображение-към-видео изходът следва съотношението на изображението - Три резолюции: 480p (по подразбиране), 720p и 1080p, последната само при модели 1.5
- Няма параметър, който да задава размер в пиксели: съотношението и резолюцията са достатъчни
- Цената е линейна, за секунда: $0.020, $0.050 или $0.080 в зависимост от модела
- Прототипирайте кратко, в 480p, с най-евтиния модел, който е достатъчен
output.upload_urlавтоматизира доставката; API Batch заобикаля ограниченията на скоростта, без отстъпка за видео