Italiano

Ogni dimensione delle miniature, nome file e proporzioni di YouTube

Un riferimento per gli otto file di miniatura che YouTube pubblica per video: indirizzi, dimensioni reali, letterbox, disponibilità WebP e quanto attendibilmente ciascuno di essi esiste.

I collegamenti vengono analizzati nel tuo browser senza accesso alla rete. Premendo Recupera vengono richiesti i file pubblici direttamente da i.ytimg.com e www.youtube.com: nessun nostro server è coinvolto e nulla viene archiviato.

Il modello di indirizzo

Ogni miniatura si trova in https://i.ytimg.com/vi/<video id>/<name>.jpg, dove l'ID video è il codice carattere 11 dal collegamento. Le versioni WebP delle dimensioni dei poster sono disponibili su https://i.ytimg.com/vi_webp/<video id>/<name>.webp.

Non esiste alcuna chiave API, nessuna quota e nessun token. Questi sono file statici, motivo per cui questo strumento non necessita di account e server propri.

I cinque formati dei poster

maxresdefault — 1280x720, vero 16:9, senza barre. Esiste solo quando il video sorgente era almeno 720p. Questo è quello che vale la pena avere.

sddefault: 640x480, una tela 4:3 con l'immagine 16:9 in formato letterbox al suo interno. Spesso manca nei caricamenti più vecchi o a bassa risoluzione.

hqdefault — 480x360, anche 4:3 con barre. Presente in modo efficace per ogni video, il che lo rende il corretto fallback.

mqdefault — 320x180, true 16:9 senza barre. La migliore immagine piccola se intendi visualizzarla senza ritagliarla.

predefinito: 120x90, 4:3 con barre. Il più piccolo e anche la dimensione che YouTube restituisce come segnaposto quando non esiste un file più grande.

I tre fotogrammi dello storyboard

hq1, hq2 e hq3 sono immagini fisse 480x360 campionate vicino all'inizio, alla metà e alla fine del video. Vengono generati essenzialmente per ogni video e sono solo JPEG.

Mostrano il video piuttosto che il marketing, che a volte è più utile e a volte molto meno lusinghiero.

Letterboxing e perché è più importante del numero di pixel

Il video YouTube moderno è 16:9, ma tre delle cinque dimensioni dei poster sono archiviate su una tela 4:3. L'immagine è centrata con barre nere sopra e sotto, quindi un hqdefault 480x360 contiene circa 480x270 dell'immagine reale.

Se inserisci uno di questi file in uno slot 16:9, le barre diventano parte del tuo layout. Ritaglia le barre o scegli mqdefault o maxresdefault, che non ne hanno.

Affidabilità in breve

Sempre presente: hqdefault, mqdefault, default, hq1, hq2, hq3.

Presente solo quando la risoluzione di upload era sufficientemente alta: maxresdefault e, meno prevedibilmente, sddefault.

Una dimensione mancante può rispondere con 404 o con HTTP 200 e un segnaposto 120x90 che sostituisce l'immagine. Entrambi sono stati osservati, motivo per cui un controllo basato solo sui codici di stato non è affidabile. Questo strumento misura invece l'immagine decodificata.

Domande

C'è qualcosa di più grande di 1280x720?

Non come file di miniature pubblicato. YouTube memorizza internamente la miniatura caricata con una risoluzione più elevata, ma maxresdefault a 1280x720 è la più grande che offre pubblicamente.

Perché l'elenco WebP è più breve?

YouTube pubblica codifiche WebP solo per le cinque dimensioni dei poster; i tre fotogrammi dello storyboard esistono solo come JPEG. C'è un secondo problema, riscontrato testando anziché leggendo: il percorso /vi_webp/ viene servito senza un'intestazione Access-Control-Allow-Origin, mentre /vi/ ne viene servito uno. Una pagina Web può quindi recuperare e scaricare i file JPEG ma non può leggere affatto i byte WebP. Questo strumento offre l'indirizzo WebP come collegamento che puoi aprire o incollare in una pipeline di compilazione e non pretende di poterlo scaricare.

Questi indirizzi cambiano?

Sono stabili da molti anni, ma più che un contratto si tratta di una convenzione non documentata. Se Google li modifica, questo strumento segnalerà i file come non disponibili anziché fingere il contrario.

Limitazioni

  • Queste sono le dimensioni pubblicate da YouTube; uno strumento non può aggiungerne uno che non esiste.
  • Le dimensioni qui sono nominali. Lo strumento segnala la dimensione misurata di ogni file effettivamente recuperato, che è il numero di cui fidarsi.
  • Il modello di indirizzo è una convenzione di lunga data, non un API documentato e garantito.