Cada tamanho de miniatura, nome de arquivo e proporção do YouTube
Uma referência para os oito arquivos de miniatura que o YouTube publica por vídeo: seus endereços, dimensões reais, letterboxing, disponibilidade de WebP e quão confiável é a existência de cada um.
Os links são analisados no seu navegador sem acesso à rede. Pressionar Fetch solicita arquivos públicos diretamente de i.ytimg.com e www.youtube.com — nenhum servidor nosso está envolvido e nada é armazenado.
O padrão de endereço
Cada miniatura fica em https://i.ytimg.com/vi/<video id>/<name>.jpg, onde o ID do vídeo é o código de 11 caracteres do link. As versões WebP dos tamanhos dos pôsteres estão disponíveis em https://i.ytimg.com/vi_webp/<video id>/<name>.webp.
Não há chave API, nem cota nem token. Esses são arquivos estáticos, por isso esta ferramenta não precisa de conta nem de servidor próprio.
Os cinco tamanhos de pôster
maxresdefault — 1280x720, verdadeiro 16:9, sem barras. Existe apenas quando o vídeo de origem tem pelo menos 720p. Este é o que vale a pena ter.
sddefault — 640x480, uma tela 4:3 com a imagem 16:9 em caixa de correio dentro dela. Muitas vezes ausente em uploads mais antigos ou de baixa resolução.
hqdefault — 480x360, também 4:3 com barras. Apresente efetivamente todos os vídeos, o que o torna o substituto correto.
mqdefault — 320x180, verdadeiro 16:9 sem barras. A melhor imagem pequena se você pretende exibi-la sem cortar.
padrão — 120x90, 4:3 com barras. O menor e também o tamanho que o YouTube retorna como espaço reservado quando não existe um arquivo maior.
Os três quadros do storyboard
hq1, hq2 e hq3 são imagens estáticas de 480x360 amostradas perto do início, meio e fim do vídeo. Eles são gerados essencialmente para todos os vídeos e são apenas JPEG.
Eles mostram o vídeo em vez de seu marketing, que às vezes é mais útil e às vezes muito menos lisonjeiro.
Letterboxing e por que é mais importante do que a contagem de pixels
O vídeo moderno do YouTube é 16:9, mas três dos cinco tamanhos de pôster são armazenados em uma tela 4:3. A imagem é centralizada com barras pretas acima e abaixo, portanto, um hqdefault de 480x360 contém aproximadamente 480x270 da imagem real.
Se você colocar um desses arquivos em um slot 16:9, as barras se tornarão parte do seu layout. Corte as barras ou escolha mqdefault ou maxresdefault, que não possuem nenhuma.
Confiabilidade em resumo
Sempre presente: hqdefault, mqdefault, default, hq1, hq2, hq3.
Presente apenas quando a resolução de upload for alta o suficiente: maxresdefault e, menos previsivelmente, sddefault.
Um tamanho ausente pode responder com 404 ou com HTTP 200 e um espaço reservado de 120 x 90 substituindo a imagem. Ambos foram observados, e é precisamente por isso que uma verificação baseada apenas em códigos de status não é confiável. Esta ferramenta mede a imagem decodificada.
Questões
Existe algo maior que 1280x720?
Não como um arquivo de miniatura publicado. O YouTube armazena internamente a miniatura enviada em resolução mais alta, mas maxresdefault em 1280x720 é o maior que ele veicula publicamente.
Por que a lista WebP é mais curta?
O YouTube publica codificações WebP apenas para os cinco tamanhos de pôster; os três quadros do storyboard existem apenas como JPEG. Há um segundo problema, encontrado por teste e não por leitura: o caminho /vi_webp/ é servido sem um cabeçalho Access-Control-Allow-Origin, enquanto /vi/ é servido com um. Uma página da web pode, portanto, buscar e baixar os arquivos JPEG, mas não consegue ler os bytes WebP. Esta ferramenta oferece o endereço WebP como um link que você pode abrir ou colar em um pipeline de construção e não finge que pode baixá-lo.
Esses endereços mudam?
Eles permanecem estáveis há muitos anos, mas são uma convenção não documentada e não um contrato. Se o Google os alterar, esta ferramenta reportará os arquivos como indisponíveis, em vez de fingir o contrário.
Limitações
- Estes são os tamanhos que o YouTube publica; uma ferramenta não pode adicionar uma que não existe.
- As dimensões aqui são nominais. A ferramenta informa o tamanho medido de cada arquivo que realmente busca, que é o número em que você pode confiar.
- O padrão de endereço é uma convenção de longa data, não um API documentado e garantido.