日本語

YouTube のすべてのサムネイルのサイズ、ファイル名、アスペクト比

YouTube が動画ごとに公開する 8 つのサムネイル ファイルのリファレンス: アドレス、実際のサイズ、レターボックス、WebP の可用性、およびそれぞれの存在の信頼性。

リンクはネットワークにアクセスせずにブラウザで解析されます。 Fetch を押すと、公開ファイルが i.ytimg.com および www.youtube.com から直接リクエストされます。サーバーは関与せず、何も保存されません。

アドレスパターン

すべてのサムネイルは https://i.ytimg.com/vi/<video id>/<name>.jpg, にあり、ビデオ ID はリンクの 11 文字コードです。ポスター サイズの WebP バージョンは https://i.ytimg.com/vi_webp/<video id>/<name>.webp. にあります。

API キー、クォータ、トークンはありません。これらは静的ファイルであるため、このツールには独自のアカウントやサーバーが必要ありません。

ポスターの5つのサイズ

maxresdefault — 1280x720、true 16:9、バーなし。ソースビデオが少なくとも 720p の場合にのみ存在します。これは持つ価値のあるものです。

sddefault — 640x480、4:3 キャンバス内に 16:9 画像レターボックスが含まれています。古いアップロードや低解像度のアップロードでは見つからないことがよくあります。

hqdefault — 480x360、バー付きの 4:3 も。事実上すべてのビデオに存在するため、正しいフォールバックになります。

mqdefault — 320x180、バーなしの true 16:9。トリミングせずに表示する場合は、小さな画像が最適です。

デフォルト — 120x90、4:3 (バー付き)。これより大きなファイルが存在しない場合に YouTube がプレースホルダーとして返す最小のサイズ。

絵コンテの3つのフレーム

hq1、hq2、および hq3 は、ビデオの最初、中間、最後付近からサンプリングされた 480x360 の静止画です。これらは基本的にすべてのビデオに対して生成され、JPEG のみです。

彼らはマーケティングではなくビデオを見せますが、その方が有益な場合もあれば、あまりお世辞ではない場合もあります。

レターボックスと、それがピクセル数よりも重要である理由

最新の YouTube ビデオは 16:9 ですが、5 つのポスター サイズのうち 3 つは 4:3 キャンバスに保存されます。画像は中央に上下の黒いバーがあるため、480x360 の hqdefault には実際の画像のおよそ 480x270 が含まれます。

これらのファイルのいずれかを 16:9 スロットに配置すると、バーがレイアウトの一部になります。バーをトリミングするか、何もない mqdefault または maxresdefault を選択します。

一目で分かる信頼性

常に存在します: hqdefault、mqdefault、default、hq1、hq2、hq3。

アップロード解像度が十分に高い場合にのみ存在します: maxresdefault、および予想外ですが sddefault。

サイズが不足している場合は、404、または HTTP 200 と画像の代わりとなる 120x90 プレースホルダーで応答する場合があります。どちらも観察されており、まさにそれがステータス コードのみに基づくチェックの信頼性が低い理由です。このツールは、代わりにデコードされた画像を測定します。

質問

1280x720より大きいものはありますか？

公開されたサムネイル ファイルとしてではありません。 YouTube はアップロードされたサムネイルを内部的に高解像度で保存しますが、公開されている最大の解像度は maxresdefault の 1280x720 です。

WebP リストが短いのはなぜですか?

YouTube は、5 つのポスター サイズのみの WebP エンコーディングを公開しています。 3 つのストーリーボード フレームは JPEG のみとして存在します。 2 番目の落とし穴があります。読み取りではなくテストによって見つかります。/vi_webp/ パスは Access-Control-Allow-Origin ヘッダーなしで提供されますが、/vi/ には Access-Control-Allow-Origin ヘッダーがあり提供されます。したがって、Web ページは JPEG ファイルをフェッチしてダウンロードすることはできますが、WebP バイトをまったく読み取ることができません。このツールは、WebP アドレスを開いたり、ビルド パイプラインに貼り付けたりできるリンクとして WebP アドレスを提供しますが、ダウンロードできるように見せかけるものではありません。

これらのアドレスは変更されますか?

これらは長年にわたって安定していますが、契約ではなく文書化されていない慣例です。 Google がファイルを変更した場合、このツールはファイルが利用できないと報告するのではなく、利用できないと報告します。

制限事項

  • これらは YouTube が公開するサイズです。ツールは存在しないものを追加することはできません。
  • ここでの寸法は公称値です。このツールは、実際にフェッチした各ファイルの測定サイズを報告します。これは信頼できる数値です。
  • アドレス パターンは長年の慣例であり、文書化され保証された API ではありません。