Pro API: генерация видео со звуком
Клип из промпта или анимация изображения, которое ты загружаешь. Файл в формате MP4, со звуком, если ты об этом попросишь.
Отправить запрос на видео
POST /videos
{ "prompt": "a woman in a white linen dress walks along a beach at sunset, wind in her hair, she turns and smiles at the camera",
"width": 1080, "height": 1920, "audio": true }
| Поле | Тип | По умолчанию | Что делает |
|---|---|---|---|
prompt | string | required | Действие, настроение, освещение. Описывай движение. |
width, height | int | 720 x 1280 | По умолчанию вертикальный формат. Смотри таблицу цен ниже. |
mode | string | ltx25 | ltx25: движок 2.5 (звук, автоматическая длительность, 1080p, конечный кадр). turbo: быстрый и дешёвый режим в 480p, без конечного кадра. |
duration_auto | bool | true | Движок определяет длину из промпта, а length становится максимумом. Укажи false для фиксированной длины. |
length | int | 121 | Длина (или максимум) в кадрах при 24 fps, всегда вида 8n+1: 73 (3 с), 121 (5 с), 241 (10 с), 361 (15 с), 481 (20 с). |
audio | bool | false | Звук генерируется вместе с изображением (атмосфера, голос). |
image | string | Начальный кадр в base64: видео анимирует это изображение. | |
end_image | string | Конечный кадр в base64, вместе с image: клип переходит от одного к другому (только движок 2.5). | |
lora, lora_strength | string, number | Обученный персонаж в аккаунте (name из GET /loras) и его сила (от 0 до 1). | |
lora2, lora2_strength | string, number | Второй персонаж. | |
steps | int | engine | Оставь пустым. |
Ответ:
{ "jobId": "...", "seed": 908172, "cost": 30 }
Стоимость рассчитывается и объявляется при отправке, до списания каких-либо кредитов.
Форматы и цены
Видео тарифицируется по формату, по фиксированной ставке независимо от длины. База: 5 кредитов.
| Формат | Короткая сторона | Примеры размеров | Без звука | Со звуком |
|---|---|---|---|---|
| 480p | 480 | 480 x 832, 832 x 480 | 5 | 10 |
| 720p | 720 | 720 x 1280, 1280 x 720 | 10 | 20 |
| 1080p | 1080 | 1080 x 1920, 1920 x 1080 | 15 | 30 |
Режим turbo тарифицируется иначе: 480p, 1 кредит за 2,5 секунды (5 с = 2 кредита, 10 с = 4),
звук включён, без конечного кадра.
Опрос статуса, скачивание, отмена
Те же маршруты, что и для изображений, в разделе /videos.
GET /videos/{jobId}:pending/completed/failed, те же поля.GET /videos/{jobId}/file: файл MP4 (Content-Type: video/mp4).POST /videos/{jobId}/cancel: отменяет задачу, кредиты не списываются.
Видео генерируется от 1 до 5 минут, дольше при холодном старте движка. Опрашивай каждые 3 секунды и
скачивай сразу, как только статус станет completed: файл не архивируется.