유튜브 썸네일 URL 형식 – img.youtube.com 링크 총정리

유튜브 썸네일은 모두 예측 가능한 주소에 있습니다. 동영상의 11자리 ID만 알면 API 키 없이도 직접 링크를 만들 수 있습니다.

1단계: 동영상 ID 찾기

ID는 v=, youtu.be/, /shorts/ 뒤에 오는 11자입니다.

2단계: URL 만들기

https://i.ytimg.com/vi/동영상ID/파일이름.jpg

예전 도메인인 img.youtube.com/vi/동영상ID/파일이름.jpg에서도 같은 이미지가 나옵니다.

모든 파일 이름

동영상에 따라 hq1.jpghq3.jpg, mq1.jpgmq3.jpg, sd1.jpg~sd3.jpg도 있는데, 자동 장면의 큰 버전입니다.

WebP 버전

파일을 더 가볍게 하려면 vi를 vi_webp로, .jpg를 .webp로 바꾸세요.

https://i.ytimg.com/vi_webp/동영상ID/maxresdefault.webp

HTML에서 사용하기

클릭하기 전까지 무거운 유튜브 플레이어를 불러오지 않는 가벼운 ‘클릭해서 재생’ 미리보기 예시입니다.

<a href="https://www.youtube.com/watch?v=동영상ID">
  <img src="https://i.ytimg.com/vi/동영상ID/hqdefault.jpg"
       width="480" height="360" loading="lazy"
       alt="동영상 제목">
</a>

항상 작동하는 URL이 필요하면 hqdefault.jpg를 쓰세요. maxresdefault.jpg가 더 선명하지만 오래된 저해상도 동영상에는 없습니다(HD 썸네일이 없는 이유 참고).

자바스크립트로 없는 크기 감지하기

크기가 없으면 유튜브는 120 × 90 대체 이미지를 돌려줍니다. 불러온 이미지의 너비를 확인하세요.

const img = new Image();
img.onload = () => {
  const exists = img.naturalWidth > 120;
  console.log(exists ? 'HD 있음' : 'HD 없음');
};
img.src = `https://i.ytimg.com/vi/${id}/maxresdefault.jpg`;

저희 썸네일 다운로더도 정확히 이 방법으로 회색 처리할 크기를 판단합니다.

YouTube Data API와 oEmbed에서의 같은 크기

YouTube Data API를 쓰면 snippet.thumbnails가 같은 파일을 다른 이름으로 돌려줍니다.

API 키 없이도 YouTube oEmbed 엔드포인트는 제목, 채널 이름, thumbnail_url(항상 hqdefault.jpg 크기)을 JSON으로 돌려줍니다.

https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=VIDEO_ID&format=json

명령줄로 다운로드하기

썸네일 한 장:

curl -o thumb.jpg https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg

ids.txt에 있는 ID 목록으로 여러 장을 받고, HD 크기가 없으면 hqdefault로 대신 받는 예입니다(-f를 붙이면 curl이 대체 이미지를 저장하지 않고 404에서 실패합니다).

while read id; do
  curl -sf -o "$id.jpg" "https://i.ytimg.com/vi/$id/maxresdefault.jpg" \
  || curl -s -o "$id.jpg" "https://i.ytimg.com/vi/$id/hqdefault.jpg"
done < ids.txt

썸네일이 바뀐 뒤 최신 이미지 받기

크리에이터가 새 썸네일을 올려도 URL은 그대로라서 브라우저나 CDN이 예전 이미지를 계속 보여 줄 수 있습니다. 아무 파라미터나 붙이면 새로 받아 옵니다. YouTube는 이를 무시하지만 캐시는 다른 주소로 취급합니다.

https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg?v=2

그다음 내 사이트나 CDN의 캐시를 비우면 모두에게 새 이미지가 보입니다. 다른 원인과 해결법은 유튜브 썸네일이 바뀌지 않을 때를 참고하세요.