Français

Chaque taille de vignette YouTube, nom de fichier et rapport hauteur/largeur

Une référence pour les huit fichiers miniatures que YouTube publie par vidéo : leurs adresses, leurs dimensions réelles, leur mise en boîte aux lettres, la disponibilité de WebP et la fiabilité de chacun d'entre eux.

Les liens sont analysés dans votre navigateur sans accès au réseau. En appuyant sur Fetch, vous demandez des fichiers publics directement depuis i.ytimg.com et www.youtube.com — aucun de nos serveurs n'est impliqué et rien n'est stocké.

Le modèle d'adresse

Chaque miniature se trouve à https://i.ytimg.com/vi/<video id>/<name>.jpg, où l'identifiant de la vidéo est le code de caractère 11 du lien. Les versions WebP des formats d'affiche sont disponibles sur https://i.ytimg.com/vi_webp/<video id>/<name>.webp.

Il n'y a pas de clé API, pas de quota et pas de jeton. Ce sont des fichiers statiques, c'est pourquoi cet outil n'a besoin d'aucun compte ni d'aucun serveur propre.

Les cinq formats d'affiche

maxresdefault — 1280 x 720, vrai 16 :9, pas de barres. Existe uniquement lorsque la vidéo source était d'au moins 720p. C'est celui qui vaut la peine d'être possédé.

sddefault — 640 x 480, un canevas 4:3 avec l'image 16:9 en boîte aux lettres à l'intérieur. Souvent absent sur les téléchargements plus anciens ou à faible résolution.

hqdefault — 480x360, également 4:3 avec des barres. Présent pour chaque vidéo, ce qui en fait la solution de repli appropriée.

mqdefault — 320 x 180, vrai 16 :9 sans barres. La meilleure petite image si vous avez l’intention de l’afficher sans recadrage.

par défaut : 120 x 90, 4 :3 avec des barres. Le plus petit, ainsi que la taille, sont renvoyés par YouTube comme espace réservé lorsqu'un fichier plus volumineux n'existe pas.

Les trois cadres du storyboard

hq1, hq2 et hq3 sont des images fixes de 480 x 360 échantillonnées vers le début, le milieu et la fin de la vidéo. Ils sont générés pour pratiquement chaque vidéo et sont uniquement au format JPEG.

Ils montrent la vidéo plutôt que son marketing, parfois plus utile et parfois beaucoup moins flatteur.

Letterboxing et pourquoi cela compte plus que le nombre de pixels

La vidéo YouTube moderne est 16:9, mais trois des cinq tailles d'affiche sont stockées sur une toile 4:3. L'image est centrée avec des barres noires au-dessus et en dessous, donc une valeur par défaut de 480 x 360 contient environ 480 x 270 de l'image réelle.

Si vous placez l'un de ces fichiers dans un emplacement 16:9, les barres font partie de votre mise en page. Soit recadrez les barres, soit choisissez mqdefault ou maxresdefault, qui n'en ont pas.

La fiabilité en un coup d'oeil

Toujours présent : hqdefault, mqdefault, default, hq1, hq2, hq3.

Présent uniquement lorsque la résolution de téléchargement était suffisamment élevée : maxresdefault et, de manière moins prévisible, sddefault.

Une taille manquante peut répondre par un 404, ou par HTTP 200 et un espace réservé 120x90 remplaçant l'image. Les deux ont été observés, c’est précisément pourquoi une vérification basée uniquement sur les codes d’état n’est pas fiable. Cet outil mesure plutôt l’image décodée.

Questions

Existe-t-il quelque chose de plus grand que 1280x720 ?

Pas sous forme de fichier miniature publié. YouTube stocke la vignette téléchargée à une résolution plus élevée en interne, mais maxresdefault à 1280 x 720 est la plus grande résolution qu'il diffuse publiquement.

Pourquoi la liste WebP est-elle plus courte ?

YouTube publie les encodages WebP pour les cinq tailles d'affiche uniquement ; les trois cadres du storyboard existent uniquement au format JPEG. Il existe un deuxième problème, trouvé en testant plutôt qu'en lisant : le chemin /vi_webp/ est servi sans en-tête Access-Control-Allow-Origin, tandis que /vi/ est servi avec un. Une page Web peut donc récupérer et télécharger les fichiers JPEG mais ne peut pas du tout lire les octets WebP. Cet outil propose l'adresse WebP sous forme de lien que vous pouvez ouvrir ou coller dans un pipeline de build, et ne prétend pas pouvoir la télécharger.

Ces adresses changent-elles ?

Ils sont stables depuis de nombreuses années, mais il s’agit plutôt d’une convention non documentée que d’un contrat. Si Google les modifie, cet outil signalera les fichiers comme indisponibles plutôt que de prétendre le contraire.

Limites

  • Ce sont les tailles publiées par YouTube ; un outil ne peut pas en ajouter un qui n'existe pas.
  • Les dimensions ici sont nominales. L'outil indique la taille mesurée de chaque fichier qu'il récupère réellement, qui est le nombre auquel se fier.
  • Le modèle d'adresse est une convention de longue date et non une API documentée et garantie.