Медиа

Интеграция Медиа обрабатывает изображения, видео и аудио через ffmpeg — изменяет размер фото, делает превью, обрезает или склеивает ролики, конвертирует голосовое сообщение перед распознаванием. Каждое действие принимает и возвращает ссылку File, никогда не сырые байты: вся работа выполняется на отдельном, выделенном сервисе, а не внутри процесса самого сценария. Учётные данные не нужны — интеграция доступна любому сценарию с момента создания проекта.

Действия

Проверить (probe). Читает длительность, ширину/высоту, видео- и аудиокодек, битрейт и MIME-тип файла, ничего не меняя — обычный первый шаг перед тем, как решить, что делать с файлом неизвестной формы (например, с фото неизвестного размера, присланным пользователем).
Изменить размер изображения. Вписывает изображение в заданную ширину/высоту (или обрезает, чтобы заполнить её целиком), с целевым форматом (исходный, JPEG, PNG или WebP) и качеством.
Конвертировать изображение. Меняет формат и качество изображения без изменения размера.
Обрезать видео. Вырезает фрагмент, начиная с заданного момента, заданной длительности — по умолчанию быстрым копированием потока (без перекодирования), либо с полным перекодированием, если срез должен точно попасть не на ключевой кадр.
Склеить видео. Объединяет несколько роликов в один по порядку — быстрым копированием, если у всех входов уже совпадают кодек и разрешение, либо с перекодированием, если нет.
Превью видео. Захватывает один кадр в заданный момент как изображение JPEG, с необязательной целевой шириной.
Транскодировать видео. Перекодирует видео в один из нескольких фиксированных пресетов (720p/1080p для веба, пресет под размер Telegram, либо анимированный GIF) и целевой формат контейнера.
Извлечь аудио. Достаёт аудиодорожку из видеофайла в формате MP3, AAC, WAV или Ogg.
Конвертировать аудио. Меняет формат, битрейт, число каналов (моно/стерео) и частоту дискретизации аудиофайла — обычный шаг перед «Вызвать AI (распознавание)», поскольку голосовое сообщение Telegram приходит в Ogg/Opus, а некоторые бэкенды распознавания ожидают другой формат.

Типичные цепочки

Голосовое сообщение Telegram → текст. message.voice уже является File — примените к нему «Конвертировать аудио» (в MP3 или WAV), затем передайте результат в«Вызвать AI (распознавание)».
Входящее фото → уменьшенная копия в ответ. «Проверьте» входящее message.photo, чтобы узнать размер, «Измените размер изображения» (например, вписав в 800×800 в формате WebP), затем «Отправьте файл» обратно в чат.
Загрузка видео → превью. «Проверьте» длительность, сделайте «Превью видео» на фиксированной отметке времени (или доле длительности) для картинки-превью и «Транскодируйте видео» в веб-пресет перед публикацией.

Ограничения и таймауты

Каждое действие — это долгий шаг с отправкой heartbeat, а не быстрый вызов: транскодирование или крупная склейка могут занимать минуты, и платформа сообщает прогресс и позволяет отменить операцию во время выполнения (например, если сам сценарий остановлен), а не блокируется без обратной связи. Входные файлы проверяются по реальному контейнеру/кодеку до начала обработки, поэтому неподдерживаемый или повреждённый файл отклоняется рано, а не передаётся декодеру. Доступен только фиксированный набор операций — свободного доступа к произвольным опциям командной строки ffmpeg нет.