Miniatury na YouTube z szablonu: rozmiar, API i hurtowo

Żeby robić miniatury na YouTube z szablonu, zaprojektuj układ raz — twarz, duży tytuł, wyróżnione słowo, plakietkę kanału — a potem wysyłaj do API tekst i obrazki każdego filmu. Shareglint renderuje miniaturę w prawdziwym Chrome i w około sekundę zwraca JPEG albo PNG w proporcjach 16:9, jakich wymaga YouTube; cała seria renderuje się z jednego arkusza. Wbudowane są cztery szablony miniatur (video-thumbnail, thumbnail-face, thumbnail-tutorial, thumbnail-gaming); możesz też napisać własny HTML i CSS.

Szablony nie zastąpią jednorazowej miniatury, którą grafik robi do najważniejszego filmu. Opłacają się wtedy, gdy kanał publikuje dużo w jednym rozpoznawalnym stylu: odcinki podcastu, lekcje kursu, skróty meczów, cotygodniowe podsumowania wiadomości albo ten sam film w pięciu wersjach językowych.

Czego wymaga YouTube

Tak opisuje własne miniatury strona pomocy YouTube (Pomoc YouTube, stan na 4 listopada 2026):

Własne miniatury wymagają zweryfikowanego konta. Tak mają się do tego presety:

• "size": "youtube" to 1280×720. Pliki rastrowe mają dwukrotność rozmiaru szablonu, więc plik ma 2560×1440 — 16:9, czterokrotność minimalnej szerokości. Pełne 3840×2160 dostaniesz, zapisując własny szablon w rozmiarze 1920×1080.
• "size": "story" (1080×1920) daje 2160×3840 do Shorts.
• "size": "square" (1080×1080) daje okładkę podcastu 2160×2160.

Każdy wbudowany szablon układa się w każdym presecie (og 1200×630, square 1080×1080, portrait 1080×1350, story 1080×1920, pinterest 1000×1500, youtube 1280×720), więc jeden projekt obsłuży film, Shorta i post dla społeczności kanału. Jeśli twój zespół wgrywa miniatury z telefonów, trzymaj plik poniżej 2 MB: JPEG ("format": "jpeg", domyślnie jakość 85) miniatury z dużym zdjęciem zwykle się w tym mieści; rozmiar wersji PNG sprawdź, zanim na niej oprzesz publikację.

Jedna miniatura na film

curl -X POST "https://shareglint.com/v1/images?wait=true" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "template": "thumbnail-tutorial",
    "size": "youtube",
    "format": "jpeg",
    "modifications": {
      "title": "Deploy Laravel to a VPS in 10 minutes",
      "tool_name": "Laravel",
      "step_label": "Part 3",
      "level": "Beginner",
      "highlight": "10 minutes",
      "channel": "@shipfast",
      "tool_logo": "https://example.com/laravel.png",
      "screenshot": "https://example.com/terminal.png"
    }
  }'

Odpowiedź zawiera url pliku. Obrazki (tool_logo, screenshot, zdjęcie gościa) są pobierane z publicznych adresów w chwili renderowania miniatury; długie tytuły zmniejszają się, żeby zmieścić się w swoim polu, zamiast wychodzić poza obrazek. Te same wartości zwracają ten sam plik za darmo, więc ponowne uruchomienie skryptu publikującego nic nie kosztuje.

Wgrywanie przez API YouTube

Nasze API tworzy obrazek; wgranie go to jeszcze jedno wywołanie po twojej stronie. Metoda thumbnails.set z YouTube Data API przyjmuje image/jpeg albo image/png do 50 MB, wymaga OAuth z zakresem YouTube, np. youtube.upload, i kosztuje około 50 jednostek twojego limitu YouTube na wywołanie. Szkic w Node z oficjalnym klientem googleapis:

import { Readable } from 'node:stream';
import { google } from 'googleapis';

const youtube = google.youtube({ version: 'v3', auth: oauthClient });

const image = await fetch(thumbnailUrl);              // adres z renderu
await youtube.thumbnails.set({
  videoId: 'dQw4w9WgXcQ',
  media: { mimeType: 'image/jpeg', body: Readable.fromWeb(image.body) },
});

Uruchom to w tym samym zadaniu zaraz po wgraniu filmu, a film pojawi się od razu z gotową miniaturą.

Cała seria z arkusza

Przy starszych materiałach — 80 odcinkach podcastu, kursie z 30 lekcji — wpisz do arkusza jeden wiersz na film: title, highlight, channel, photo (adres URL), filename, np. ep-042.jpg, oraz id z identyfikatorem filmu na YouTube. Potem:

curl -X POST "https://shareglint.com/v1/batches" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "template": "thumbnail-face", "format": "jpeg", "sizes": ["youtube"],
        "csv_url": "https://docs.google.com/spreadsheets/d/…/edit?usp=sharing" }'

GET /v1/batches/{id} podaje postęp, a po zakończeniu adres każdego wiersza (z jego id, gotowy do thumbnails.set) i jedno archiwum ZIP. Limit wierszy na zlecenie według planu: Free 50, Starter 500, Pro 1 000, Scale 2 000, Business 5 000. Zmień jeden tytuł i uruchom zlecenie jeszcze raz, a od nowa wyrenderuje się tylko ten wiersz. Strona Bulk w panelu robi to samo z wgranego pliku CSV, z darmowym podglądem pierwszych wierszy.

Testowanie wariantów

Wbudowana w YouTube funkcja Test & compare porównuje ze sobą do trzech miniatur opublikowanego filmu, w YouTube Studio na komputerze, i zaleca co najmniej 1280×720 dla każdego wariantu. Dzięki szablonowi warianty są tanie: ten sam film z tytułem w formie pytania albo stwierdzenia, z innym wyróżnionym słowem, z jasnym albo ciemnym theme, z innym kolorem accent. Każdy wariant to jeden render; wyrenderuj trzy, wgraj je do testu i zostaw zwycięzcę. Nie prowadzimy testu ani nie czytamy twoich statystyk — robi to YouTube Studio.

Projekt, który działa w rozmiarze miniatury

• Mało słów, duże litery. Miniaturę często widać w ułamku jej rozmiaru — w wynikach wyszukiwania i na telefonach; 4–6 słów grubym krojem da się przeczytać, całego zdania już nie. Pole highlight koloruje jedno albo dwa słowa.
• Twarze i kontrast. Szablony z polem photo albo face_photo wkomponowują portret w układ; wybierz zdjęcie, na którym osoba jest dobrze oświetlona, a tło proste.
• Zostaw wolny prawy dolny róg. YouTube wyświetla tam długość filmu.
• Własne fonty? Szablony używają krojów zainstalowanych w naszym rendererze (GET /v1/fonts); pliku z fontem nie wgrasz. Lista jest krótka — Roboto, Open Sans, Ubuntu i kilka innych — więc jeśli wygląd twojego kanału zależy od konkretnego kroju tytułowego, najpierw sprawdź listę.

Koszt

Jeden render na miniaturę i rozmiar. Kanał z jednym filmem tygodniowo, jedną miniaturą i dwoma wariantami zużywa około 12 renderów miesięcznie; 300 starszych filmów w jednym rozmiarze to 300 renderów. 100 renderów miesięcznie w planie Free ma znak wodny — w sam raz do wypróbowania szablonów, nie do publikacji. Starter kosztuje $9 miesięcznie za 2 000 renderów bez znaku wodnego (cennik).

Czego nie robi

• Nie wgrywa niczego na YouTube i nie czyta YouTube Analytics; robi to twój skrypt albo YouTube Studio.
• Nie wybiera klatki z twojego filmu. W polu obrazka użyj wyeksportowanego kadru albo zdjęcia.
• Żadnych twarzy ani scen generowanych przez AI: szablon układa obrazki, które dostarczysz.
• Animacje (GIF/MP4 do 5 s) są dostępne, ale miniatury na YouTube to obrazy statyczne, więc używaj JPEG albo PNG.