Возможности

Всё, что сервис умеет делать с файлом от момента загрузки до момента выдачи.

Приём файлов

Исходник можно передать тремя способами: указать прямую ссылку и мы заберём файл сами, отправить составным запросом или залить по частям, если канал ненадёжный. Части собираются на нашей стороне, порядок не важен, повторная отправка одной и той же части безопасна.

Параметр	Значение
Максимальный размер файла	20 ГБ
Размер части при дробной загрузке	от 5 МБ до 512 МБ
Время жизни незавершённой загрузки	48 часов
Контейнеры	mp4, mov, mkv, avi, webm, mxf, ts
Кодеки на входе	H.264, H.265, VP9, AV1, ProRes, DNxHD

Профили кодирования

Пресет — это именованный набор параметров. Можно взять готовый или описать свой и сохранить в проекте, чтобы не передавать полтора десятка полей в каждом запросе.

Пресет	Что делает
`web-hd`	H.264 1080p, 4.5 Мбит/с, AAC 128 кбит/с, faststart
`web-sd`	H.264 720p, 2 Мбит/с — для медленных каналов
`mobile`	H.264 540p, 1 Мбит/с, звук в моно
`hls-adaptive`	четыре дорожки от 360p до 1080p и общий плейлист
`archive`	H.265 с сохранением исходного разрешения
`audio-only`	извлечение звуковой дорожки в mp3 или aac

Дополнительная обработка

кадры-превью на заданных секундах или равномерно по длине ролика;
обрезка по таймкодам без повторного кодирования, если кодек совпадает;
наложение картинки в углу кадра с отступами и прозрачностью;
нормализация громкости по EBU R128;
вшивание субтитров или отдельная дорожка WebVTT;
поворот и отражение по метаданным съёмки.

Выдача результата

Готовый файл доступен по адресу вида /video/download с идентификатором задачи. Отдача поддерживает диапазонные запросы, поэтому перемотка в плеере работает без скачивания всего файла, а прерванная загрузка продолжается с места обрыва.

Ссылку можно сделать подписанной и ограниченной по времени. Тогда без действительной подписи сервер отвечает 403, а после истечения срока — 410.

Уведомления

Когда задача меняет состояние, мы дёргаем указанный вами адрес методом POST. Если ответ не 2xx, повторяем с растущими паузами: через 30 секунд, 2 минуты, 10 минут и час. После четвёртой неудачи задача помечается как доставленная с ошибкой и остаётся видимой в отчёте.