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

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

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

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

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

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

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

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

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

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

    

      

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

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

    

      

    
    54 ₽/с × 8 с = 432 ₽
  

Ограничения

• Видеомодели нельзя подключить к AI-агенту или использовать в чате и мобильном приложении.

• Генерация может завершиться со статусом failed, если запрос не прошел модерацию контента.

• Runway Gen-4 Turbo создает видео только по изображению. Для запроса необходимо передать input_reference.

• У моделей Kling разрешение определяется вариантом модели: Standard создает видео в 720p, Pro — в 1080p, 4K — в 2160p.

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

Для работы с видеомоделями нужен API-ключ AI Gateway.

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

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 списывает фактическую стоимость и возвращает неиспользованную часть резерва в доступный баланс.

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

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

Если задача остается в статусе queued или in_progress больше часа, резерв не возвращается дольше шести часов либо списанная сумма не соответствует тарифу, обратитесь в поддержку. Укажите имя API-ключа, модель, время запроса, идентификатор видео, параметры запроса и полный текст ошибки. Сам API-ключ передавать не нужно.