Wielki tytuł wersalikami na zdjęciu, wyróżniona druga linia, kanał i czas trwania — w stylu YouTube.
To prawdziwy render z API z przykładowymi wartościami z tabeli niżej, w rozmiarze 1200×630.
Wygląd, w który ludzie już klikają: ciemny gradient na kadrze, ogromny tytuł z drugą linią na kolorowym pasku, kanał na dole i czas trwania w rogu. Do stron z wideo, zwiastunów kursów i klipów do mediów społecznościowych.
Każde pole jest opcjonalne. Za długi tekst zmniejsza się, zamiast wychodzić poza kadr; pole obrazka przyjmuje publiczny adres URL, który pobieramy po naszej stronie.
| Pole | Typ | Opis | Przykład |
|---|---|---|---|
title |
tekst | Pierwsza linia tytułu. domyślnie: Video title | I hiked the Alps |
highlight |
tekst | Druga linia na kolorowym pasku. | in 3 days |
badge |
tekst | Etykieta w górnym rogu, np. NOWE. | NEW |
channel |
tekst | Nazwa kanału albo twórcy. | Trail Notes |
duration |
tekst | Czas trwania, np. 48 min. | 14:27 |
image |
adres obrazka | Zdjęcie w tle. | https://example.com/images/mountains.jpg |
avatar |
adres obrazka | Awatar kanału. | https://example.com/images/avatar-man2.jpg |
accent |
kolor | Kolor marki w zapisie hex, np. #6366f1. Barwi przyciski, wyróżnienia i poświatę w tle. domyślnie: #facc15 | #facc15 |
theme |
dark | light | Schemat kolorów: dark albo light. | — |
Slug podajesz jako template. W odpowiedzi dostajesz adres gotowego PNG; ?wait=true trzyma połączenie, aż obrazek będzie gotowy.
curl -X POST "https://imageapi.benchkithq.com/v1/images?wait=true" \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"template": "video-thumbnail",
"modifications": {
"title": "I hiked the Alps",
"highlight": "in 3 days",
"badge": "NEW",
"channel": "Trail Notes",
"duration": "14:27",
"image": "https://example.com/images/mountains.jpg",
"avatar": "https://example.com/images/avatar-man2.jpg"
}
}'
Dla stron statycznych, Webflow, Shopify i narzędzi no-code: pola idą w query stringu, a całość podpisujesz swoim sekretem. Pierwsze żądanie renderuje obrazek, każde kolejne to przekierowanie na gotowy plik. Jak policzyć podpis.
<meta property="og:image" content="https://imageapi.benchkithq.com/i/acc_YOUR_ACCOUNT_ID/video-thumbnail.png?badge=NEW&channel=Trail%20Notes&duration=14%3A27&highlight=in%203%20days&title=I%20hiked%20the%20Alps&s=YOUR_SIGNATURE">
accent i theme zmieniasz w każdym żądaniu. Jeśli chcesz więcej, skopiuj szablon na swoje konto: dostajesz zwykły szablon HTML z tymi samymi polami, który edytujesz w panelu albo przez API. Jeśli slug jest na Twoim koncie wolny, kopia go przejmuje — Twoje integracje przechodzą na Twoją wersję bez zmiany jednej linijki.
curl -X POST "https://imageapi.benchkithq.com/v1/templates/library/video-thumbnail/copy" \
-H "Authorization: Bearer sk_live_YOUR_KEY"
Wpis na blogu
Oferta pracy
Wydarzenie
Odcinek podcastu
Changelog / wydanie
Strona dokumentacji
Oferta nieruchomości
Karta produktu
Produkt w promocji
Lekcja kursu
Przepis
Wydanie newslettera
Karta z cytatem
Case study / opinia klienta
Repozytorium GitHub
Zapowiedź funkcji
Profil / karta autora
Porównanie (A vs B)
Wyróżniona liczba