Каждый размер миниатюр YouTube, имя файла и соотношение сторон
Ссылка на восемь файлов миниатюр, которые YouTube публикует для каждого видео: их адреса, истинные размеры, почтовый ящик, доступность WebP и надежность существования каждого из них.
Ссылки анализируются в вашем браузере без доступа к сети. Нажатие Fetch запрашивает публичные файлы напрямую с i.ytimg.com и www.youtube.com — наш сервер не задействован и ничего не сохраняется.
Шаблон адреса
Каждая миниатюра находится по адресу https://i.ytimg.com/vi/<video id>/<name>.jpg, где идентификатор видео — это 11-символьный код из ссылки. Версии размеров плакатов WebP доступны по адресу https://i.ytimg.com/vi_webp/<video id>/<name>.webp.
Нет ни ключа API, ни квоты, ни токена. Это статические файлы, поэтому этому инструменту не требуется ни учетная запись, ни собственный сервер.
Пять размеров плакатов
maxresdefault — 1280x720, правда 16:9, полос нет. Существует только тогда, когда исходное видео было не ниже 720p. Это то, что стоит иметь.
sddefault — 640x480, холст 4:3 с изображением 16:9 внутри него. Часто отсутствует в старых загрузках или загрузках с низким разрешением.
hqdefault — 480x360, также 4:3 с полосами. Фактически присутствует в каждом видео, что делает его подходящим запасным вариантом.
mqdefault — 320x180, true 16:9 без полос. Лучшее маленькое изображение, если вы собираетесь отображать его без обрезки.
по умолчанию — 120x90, 4:3 с полосами. Самый маленький, а также размер, который YouTube возвращает в качестве заполнителя, когда файл большего размера не существует.
Три кадра раскадровки
hq1, hq2 и hq3 — это кадры размером 480x360, взятые из начала, середины и конца видео. Они генерируются практически для каждого видео и предназначены только для JPEG.
Они показывают видео, а не его рекламу, которая иногда более полезна, а иногда гораздо менее лестна.
Леттербоксинг и почему он важнее количества пикселей
Современное видео YouTube имеет формат 16:9, но три из пяти размеров плаката хранятся на холсте 4:3. Изображение центрировано с черными полосами сверху и снизу, поэтому hqdefault размером 480x360 содержит примерно 480x270 фактического изображения.
Если вы поместите один из этих файлов в слот 16:9, полосы станут частью вашего макета. Либо обрежьте полосы, либо выберите mqdefault или maxresdefault, у которых их нет.
Надежность с первого взгляда
Всегда присутствует: hqdefault, mqdefault, default, hq1, hq2, hq3.
Присутствует только тогда, когда разрешение загрузки было достаточно высоким: maxresdefault и, что менее предсказуемо, sddefault.
Отсутствующий размер может быть ответом 404 или HTTP 200 и заполнителя 120x90, заменяющего изображение. Оба варианта наблюдались, и именно поэтому проверка, основанная только на кодах состояния, ненадежна. Вместо этого этот инструмент измеряет декодированное изображение.
Вопросы
Есть ли что-нибудь больше 1280x720?
Не как опубликованный файл миниатюр. YouTube хранит загруженную миниатюру в более высоком разрешении внутри себя, но maxresdefault с разрешением 1280x720 является самым большим, который доступен публично.
Почему список WebP короче?
YouTube публикует кодировки WebP только для пяти размеров плакатов; три кадра раскадровки существуют только как JPEG. Есть вторая проблема, обнаруженная при тестировании, а не при чтении: путь /vi_webp/ обслуживается без заголовка Access-Control-Allow-Origin, а /vi/ обслуживается с ним. Таким образом, веб-страница может получать и загружать файлы JPEG, но вообще не может читать байты WebP. Этот инструмент предлагает адрес WebP в качестве ссылки, которую вы можете открыть или вставить в конвейер сборки, и не претендует на возможность его загрузки.
Эти адреса меняются?
Они стабильны уже много лет, но представляют собой скорее недокументированную конвенцию, чем контракт. Если Google изменит их, этот инструмент сообщит о том, что файлы недоступны, а не сделает вид, что это не так.
Ограничения
- Это размеры, которые публикует YouTube; инструмент не может добавить тот, который не существует.
- Размеры здесь номинальные. Инструмент сообщает измеренный размер каждого файла, который он фактически извлекает, и этому числу можно доверять.
- Шаблон адреса — это давнее соглашение, а не документированное и гарантированное API.