video-thumbnail

Szablon obrazka OG: miniatura wideo

Wielki tytuł wersalikami na zdjęciu, wyróżniona druga linia, kanał i czas trwania — w stylu YouTube.

Szablon obrazka Open Graph „miniatura wideo” wyrenderowany przez Image API

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.

Pola

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. —

Wyrenderuj go jednym żądaniem

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"
    }
}'

Albo wklej podpisany adres w og:image

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">

Dopasuj do siebie

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"

Więcej szablonów obrazków OG

Wszystkie szablony →