Большинство команд начинают использовать Cloudinary для решения сиюминутных задач — обычно для загрузки файла, встраивания видео или изменения размера изображения. Функция развернута, и команда идет дальше. Но Cloudinary Video API включает в себя возможности, которые выходят далеко за рамки простой загрузки и доставки, и многие из них могут полностью исключить ручную работу по редактированию.
В этом руководстве рассматриваются семь видеофункций, встроенных в API, которые часто остаются неиспользованными: умная обрезка с использованием ИИ (AI gravity), динамические наложения, автосубтитры и разбивка на главы, подписанные URL-адреса с истекающим сроком действия, замена аудио, созданные с помощью ИИ превью видео и объединение видеоклипов. Для каждой функции приведены сценарии использования, детали реализации и примеры кода, которые можно добавить в ваш проект.
В конце вы узнаете, как:
- Автоматически обрезать и кадрировать видео для любых соотношений сторон с помощью AI gravity.
- Накладывать изображения, текст и видеоклипы на базовое видео в момент доставки.
- Генерировать транскрипции, субтитры и маркеры глав из загруженных видео.
- Защищать доступ к видео с помощью подписанных URL-адресов с ограничением по времени.
- Заменять или отключать аудиодорожки без повторного редактирования исходного файла.
- Генерировать короткие превью видео и анимированные GIF-файлы, выбранные с помощью ИИ.
- Объединять несколько клипов в одно видео с помощью параметров URL.
Для работы с примерами кода вам понадобятся:
- Бесплатная учетная запись Cloudinary. Запишите имя вашего облака (cloud name) из панели управления.
- Установленный SDK Cloudinary для Node.js (npm install cloudinary).
- Хотя бы одно видео, загруженное в вашу медиабиблиотеку Cloudinary.
Некоторые функции (автосубтитры, тегирование с помощью ИИ) требуют включения дополнительных модулей (add-ons) в вашей учетной записи Cloudinary. В соответствующих разделах указано, когда необходим дополнительный модуль.
Cloudinary анализирует видеоконтент кадр за кадром и удерживает самый важный объект в кадре при изменении обрезки и соотношения сторон. Вместо того чтобы вручную редактировать отдельные версии для Stories, Reels и ландшафтных веб-плееров, вы генерируете все варианты из одного исходного видео.
Когда это использовать:
- Доставка вертикальных, квадратных и ландшафтных версий из одного базового видео с удержанием лиц или продуктов в кадре.
- Автоматическое кадрирование лекций или интервью с удержанием спикера по центру без ручного редактирования.
Как это реализовать:
Установите параметр gravity в значение auto в цепочке трансформаций. вы также можете нацеливаться на определенные объекты с помощью auto:object:
Параметр g_auto сообщает Cloudinary о необходимости обнаружить наиболее важную с визуальной точки зрения область в каждом кадре и удерживать ее по центру во время обрезки.
Вы можете накладывать изображения, видео или стилизованный текст на базовое видео в момент доставки. Это означает водяные знаки, брендированные призывы к действию (CTA), персонализированный текст (например, имя клиента) или даже короткий рекламный клип, наложенный на видео, и все это без редактирования исходного файла.
Когда это использовать:
- Добавление брендированного водяного знака или QR-кода к каждому видео.
- Внедрение динамического текста вроде «Поздравляем, [Имя]!» или таймеров обратного отсчета.
- Добавление в начало или конец короткого рекламного клипа (видео поверх видео).
Как это реализовать:
Используйте флаги overlay и layer_apply в вашей трансформации:
Первый блок накладывает рекламный видеоклип. Второй накладывает логотип в правый нижний угол. Оба применяются в момент доставки через параметры URL.
Модули транскрипции Cloudinary на базе ИИ генерируют разбитые по спикерам транскрипции с временными метками в течение нескольких минут после загрузки. Эти транскрипции поступают в наложения субтитров, текстовые слои с возможностью поиска или метаданные глав. Функция поддерживает более 100 языков и исключает ручное редактирование субтитров.
Когда это использовать:
- Автоматическое добавление субтитров для доступности (accessibility) и SEO.
- Отображение интерактивной транскрипции рядом с видео для поиска и навигации.
- Генерация маркеров глав для длинного контента, такого как вебинары и руководства.
Как это реализовать:
Включите модуль транскрипции Google или Azure в своей учетной записи Cloudinary. Затем установите raw_convert или auto_transcription в вызове загрузки:
Примечание:
Модуль транскрипции должен быть включен в вашей учетной записи Cloudinary до того, как это заработает. Перейдите в Settings > Add-ons для его установки.
Подписанные URL-адреса включают временную метку истечения срока действия и криптографическую подпись. CDN Cloudinary проверяет оба параметра при каждом запросе. Если время истекло или подпись не совпадает, CDN блокирует доступ. В сочетании с пресетами загрузки на основе ролей вы можете ограничить типы трансформаций, которые могут применять разные категории клиентов.
Когда это использовать:
- Защита премиального или закрытого контента с помощью ограниченного по времени доступа.
- Ограничение трансформаций или загрузок на основе роли клиента (администратор или публичный пользователь).
Как это реализовать:
Установите sign_url: true и expires_at в SDK:
Всегда генерируйте подписанные URL-адреса на вашем сервере, никогда — в клиентском коде. Подпись использует ваш секретный ключ API (API secret), который должен оставаться конфиденциальным.
Cloudinary позволяет заменять, отключать или накладывать аудиодорожки с помощью параметров трансформации. Вы накладываете аудиофайл на базовое видео, регулируете уровень громкости с помощью e_volume и управляете кодированием с помощью audio_codec. Никакого ручного редактирования или повторной загрузки не требуется.
Когда это использовать:
- Замена оригинального аудио на локализованную озвучку (английский дубляж на французский).
- Добавление фоновой музыки к загруженным клиентами видео.
- Отключение звука, защищенного авторским правом, или нежелательного аудио.
Как это реализовать:
Укажите наложение с аудиофайлом и примените флаги: layer_apply:
Параметр audio_codec: 'aac' гарантирует, что финальное видео будет иметь корректное аудиокодирование для широкой совместимости с браузерами.
Cloudinary анализирует видео с помощью глубокого обучения, определяет наиболее привлекательные фрагменты и объединяет их в короткое превью или анимированный GIF. Это автоматизирует работу по просмотру материала в поисках лучших моментов.
Когда это использовать:
- Создание превью при наведении курсора на сетки миниатюр видео.
- Генерация коротких клипов для продвижения в социальных сетях.
- Демонстрация быстрых превью товаров на страницах электронной коммерции.
Как это реализовать:
Используйте параметр e_preview в URL доставки. Вы можете управлять общей продолжительностью и количеством сегментов:
Это генерирует пятисекундный анимированный GIF-файл из самых интересных моментов видео.
Cloudinary позволяет объединять несколько видеоклипов или изображений в одно видео с помощью параметров URL. Флаг fl_splice добавляет наложенный ресурс в конец базового видео вместо того, чтобы отображать его поверх него.
Когда это использовать:
- Добавление в начало персонализированного приветственного клипа или визитки к руководству по продукту.
- Добавление аутро с призывом к действию (CTA) к каждому видео в рекламной кампании.
- Автоматизация массового создания видео из многоразовых сегментов.
Как это реализовать:
Используйте l_video:, чтобы указать ресурс для добавления, а затем fl_splice и fl_layer_apply:
Это добавляет outro_clip в конец product_demo. Вы можете объединять несколько склеек в цепочки для построения более длинных последовательностей из многоразовых сегментов.
Чтобы увидеть, как эти функции работают вместе, рассмотрим платформу электронной коммерции, где продавцы загружают видео о товарах.
Когда поступает новое видео о товаре, обрезка g_auto генерирует вертикальные, квадратные и ландшафтные варианты для различных платформ. Если видео содержит звук, вы можете заменить его на локализованную озвучку для разных регионов или отключить для контекстов с автовоспроизведением.
Для рекламных акций текстовые наложения внедряют коды скидок или информацию о товаре непосредственно в видео на основе правил кампании без редактирования исходного файла. Для более длинных обзоров продуктов авторазбивка на главы позволяет клиентам переходить к разделам, которые имеют наибольшее значение (характеристики, установка, инструкции).
На страницах списков e_preview генерирует короткие превью при наведении курсора, показывающие продукт в динамике. Автоматические субтитры добавляют текст для доступности и SEO. Для продуктов с ранним доступом подписанные URL-адреса ограничивают просмотр авторизованными клиентами с помощью ссылок с ограниченным сроком действия.
Каждая функция работает через один и тот же API. Один исходный видеофайл. Множество результатов. Никакого ручного монтажа.
- Используйте предварительные трансформации для тяжелой обработки. Сложные операции, такие как начальная обрезка, замена звуковой дорожки и генерация глав, должны выполняться в момент загрузки, а не в момент выдачи контента. Это переносит затраты на обработку с запроса первого зрителя на этап загрузки, обеспечивая быструю первую загрузку для ресурсов с высоким трафиком.
- Оставьте динамические трансформации «на лету» для динамического контента. Наложение уникальных промокодов на основе клиентских данных или генерация персонализированного текста должны происходить в момент выдачи, поскольку результат меняется для каждого запроса.
- Всегда включайте f_auto и q_auto. Эти два параметра автоматически выбирают наиболее эффективный формат и уровень сжатия для браузера каждого зрителя. Они должны присутствовать в каждом URL-адресе продакшн-видео.
- Генерируйте подписанные URL-адреса только на стороне сервера. Подписанные URL-адреса содержат ваш секретный ключ API в своей подписи. Всегда генерируйте их на своем сервере. Никогда не раскрывайте логику подписания в клиентском коде.
Эти семь функций встроены в Cloudinary Video API. Они не требуют отдельного программного обеспечения для монтажа, дополнительной инфраструктуры или сложных серверных скриптов. Каждая из них доступна через параметры URL или вызовы SDK.
Выберите одну функцию, которая решает проблему в вашем текущем рабочем процессе, и попробуйте ее. Умная обрезка и f_auto/q_auto дают самые быстрые результаты. Автоматические субтитры и превью видео обычно оказывают наибольшее влияние на вовлеченность. Замена аудио и конкатенация открывают возможности для локализации и персонализации, которые в противном случае потребовали бы полноценного конвейера видеомонтажа.
Вот несколько дальнейших шагов:
- Начните с умной обрезки. Создайте три варианта соотношения сторон для вашего самого просматриваемого видео и сравните вовлеченность на разных платформах.
- Добавьте автоматические субтитры к новым загрузкам. Включите надстройку транскрипции и установите raw_convert в пресете загрузки, чтобы каждое видео автоматически получало субтитры.
- Создайте сетку превью. Используйте e_preview для генерации анимированных GIF-превью при наведении на страницы с миниатюрами видео. Измерьте, увеличивают ли миниатюры с поддержкой превью показатели кликабельности.
- Протестируйте замену аудио для локализации. Возьмите одну демонстрацию продукта и создайте версии с озвучкой на двух или трех языках, используя наложение звука.
Ресурсы:
- Документация по видеотрансформациям Cloudinary
- Документация по наложению видео
- Автоматические субтитры и транскрипция
- Подписанные URL-адреса и контроль доступа
- Документация по Video Player
- Глоссарий изображений и видео
ИИ-фокус, задаваемый с помощью параметра g_auto, анализирует видеоконтент кадр за кадром, чтобы обнаружить наиболее важный с визуальной точки зрения объект и удерживать его в кадре при обрезке или изменении соотношения сторон. Это позволяет создавать вертикальные, квадратные и горизонтальные варианты из одного исходного видео без ручного перемонтажа каждого из них.
Да. Надстройки транскрипции Cloudinary на базе ИИ генерируют расшифровки с разбивкой по спикеру и временными метками вскоре после загрузки, поддерживая более 100 языков, которые затем можно использовать для наложения субтитров или меток глав.
Да. Cloudinary позволяет накладывать новую аудиодорожку на существующее видео, регулировать громкость и задавать аудиокодек полностью через параметры трансформации, поэтому локализованную озвучку или фоновую музыку можно добавлять в момент выдачи.
Используя трансформацию e_preview, Cloudinary применяет глубокое обучение для определения наиболее интересных фрагментов видео и объединяет их в короткое превью или анимированный GIF, полезный для превью при наведении, кликов для соцсетей или миниатюр демонстрации продуктов. Параметры конфигурации, такие как длительность и количество сегментов, подробно описаны в документации по превью и постерам видео.
Нет. Флаг Cloudinary fl_splice позволяет присоединять один видеоклип к другому напрямую через параметры URL, что полезно для добавления интро, аутро или персонализированных заставок без конвейера видеомонтажа. В документации по конкатенации видео описан полный синтаксис, включая объединение нескольких вставок в цепочку.
