---
title: "Работа с видео"
---

# Работа с видео

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

В AI Gateway доступны модели для генерации видео по текстовому описанию и изображению. С их помощью можно создавать ролики для приложений, рекламы, социальных сетей и других сценариев.

Видеомодели работают только через API по ключу AI Gateway. Использовать их в AI-агентах, чате и мобильном приложении нельзя. Генерация выполняется асинхронно и может занимать несколько минут: сначала создается задача, затем ее статус проверяется отдельными запросами.

## Поддерживаемые модели и стоимость

Стоимость видео рассчитывается по длительности ролика. Текст промпта отдельно не тарифицируется. К указанным ценам применяются персональные скидки на ИИ, если они подключены для аккаунта.

### Модели с фиксированной стоимостью

| **Модель** | **Стоимость, ₽/с** | **Особенности** |
| --- | --- | --- |
| Runway Gen-4 Turbo | 6,75 | Генерация только по изображению |
| Runway Gen-4.5 | 16,2 | — |
| Kling 2.5 Turbo Pro | 16,2 | — |
| Kling O3 Standard | 17,55 | — |
| Seedance 2.0 Mini | 21,6 | Минимальная стоимость ролика — 86,4 ₽ |
| Kling O3 Pro | 22,95 | — |
| Seedance 2.0 Fast | 39,15 | — |
| Kling 3.0 4K | 58,05 | — |
| Kling O3 4K | 58,05 | — |

### Модели со звуком и без него

| **Модель** | **Без звука, ₽/с** | **Со звуком, ₽/с** |
| --- | --- | --- |
| Kling 3.0 Standard | 12,15 | 17,55 |
| Veo 3.1 Fast | 13,5 | 20,25 |
| Kling 3.0 Pro | 16,2 | 22,95 |
| Veo 3.1 | 27 | 54 |

### Модели с тарификацией по разрешению

| **Модель** | **Разрешение** | **Стоимость, ₽/с** |
| --- | --- | --- |
| Hailuo H3 Max | 480p | 6,75 |
| Hailuo H3 Max | Выше 480p | 10,8 |
| Wan 3 | 480p | 6,75 |
| Wan 3 | 720p | 13,5 |
| Wan 3 | 1080p | 27 |
| Wan 3 Prime | 480p | 9,18 |
| Wan 3 Prime | 720p | 18,9 |
| Wan 3 Prime | 1080p | 37,8 |
| Hailuo 3 | До 768p | 13,5 |
| Hailuo 3 | Выше 768p | 20,25 |
| Seedance 2.5 | 480p | 27 |
| Seedance 2.5 | 720p | 40,5 |
| Seedance 2.5 | Выше 720p | 91,8 |
| Seedance 2.0 | До 720p | 48,6 |
| Seedance 2.0 | 1080p | 54 |
| Seedance 2.0 | Выше 1080p | 202,5 |

Для Hailuo 3 каждое изображение-референс оплачивается дополнительно — 2,7 ₽. Минимальная стоимость ролика Seedance 2.5 составляет 108 ₽.

Итоговая стоимость рассчитывается по формуле:

```shell
стоимость = цена за секунду × длительность видео в секундах
```

Например, восемь секунд видео, созданного моделью Veo 3.1 со звуком, стоят:

```shell
54 ₽/с × 8 с = 432 ₽
```

## Ограничения

-   Видеомодели нельзя подключить к AI-агенту или использовать в чате и мобильном приложении.
    
-   Генерация может завершиться со статусом `failed`, если запрос не прошел модерацию контента.
    
-   Runway Gen-4 Turbo создает видео только по изображению. Для запроса необходимо передать `input_reference`.
    
-   У моделей Kling разрешение определяется вариантом модели: Standard создает видео в 720p, Pro — в 1080p, 4K — в 2160p.
    

## Как работает генерация

Для работы с видеомоделями нужен [API-ключ AI Gateway](https://timeweb.cloud/docs/ai-gateway/manage#sozdanie-api-klucha).

Генерация выполняется асинхронно:

1.  Приложение создает задачу с помощью `POST /v1/videos` и получает ее идентификатор.
    
2.  Приложение проверяет состояние задачи с помощью `GET /v1/videos/{id}`. Статусы `queued` и `in_progress` означают, что задача находится в очереди или обрабатывается. Статус `failed` означает, что создать видео не удалось.
    
3.  После успешного завершения приложение скачивает ролик с помощью `GET /v1/videos/{id}/content`.
    

## Резервирование и списание средств

Перед запуском генерации AI Gateway резервирует на балансе сумму с запасом. Для расчета резерва используются параметры запроса:

-   если `seconds` не указан, в расчет берется длительность 10 секунд;
    
-   если `size` не указан, резерв рассчитывается по самому дорогому доступному разрешению;
    
-   если модель поддерживает звук и соответствующий параметр не указан, для расчета звук считается включенным.
    

Чтобы сумма резерва была ближе к итоговой стоимости, явно указывайте длительность, разрешение и наличие звука, если выбранная модель поддерживает эти параметры.

Если доступных средств не хватает, API вернет ошибку `402`, а генерация не запустится.

После завершения видео AI Gateway списывает фактическую стоимость и возвращает неиспользованную часть резерва в доступный баланс.

Запросы на проверку статуса и скачивание готового ролика бесплатны.

## Возможные ошибки

| **Код** | **Причина** | **Рекомендуемые действия** |
| --- | --- | --- |
| `400` | Некорректные параметры запроса | Проверьте обязательные поля, допустимые значения и формат запроса для выбранной модели |
| `402` | Недостаточно средств | Пополните баланс или уменьшите длительность и разрешение видео |
| `404` | Модель или задача не найдена | Проверьте идентификатор задачи и имя модели с учетом регистра |
| `405` | Метод или модель не поддерживаются | Проверьте эндпоинт и убедитесь, что выбранная модель поддерживает генерацию видео |
| `5xx` | Ошибка на стороне провайдера | Повторите запрос позже. Если ошибка возникает в нескольких запросах подряд, обратитесь в поддержку |

Если задача остается в статусе `queued` или `in_progress` больше часа, резерв не возвращается дольше шести часов либо списанная сумма не соответствует тарифу, [обратитесь в поддержку](https://timeweb.cloud/my/support/help-question). Укажите имя API-ключа, модель, время запроса, идентификатор видео, параметры запроса и полный текст ошибки. Сам API-ключ передавать не нужно.