Jedna duża liczba z tym, co znaczy, i skąd pochodzi.
To prawdziwy render z API z przykładowymi wartościami z tabeli niżej, w rozmiarze 1200×630.
Do raportów, podsumowań roku i wpisów z danymi: liczba wypełnia pół kadru gradientem, wyjaśnienie stoi obok, a źródło w stopce. Długie liczby zmniejszają się zamiast łamać.
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 |
|---|---|---|---|
value |
tekst | Liczba, np. 87%. Długie liczby zmniejszają się, żeby się zmieścić. domyślnie: 100% | 87% |
label |
tekst | Co ta liczba znaczy. | of links shared on LinkedIn get more clicks with a custom preview image |
source |
tekst | Skąd pochodzi liczba. | Source: State of Social Previews 2026 |
eyebrow |
tekst | Krótka etykieta nad tytułem. | Research |
site |
tekst | Twoja domena albo krótki adres. | northwind.dev/report |
logo |
adres obrazka | Logo wydawcy. | https://example.com/images/logo-northwind.png |
accent |
kolor | Kolor marki w zapisie hex, np. #6366f1. Barwi przyciski, wyróżnienia i poświatę w tle. domyślnie: #f97316 | #f97316 |
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": "stat-highlight",
"modifications": {
"value": "87%",
"label": "of links shared on LinkedIn get more clicks with a custom preview image",
"source": "Source: State of Social Previews 2026",
"eyebrow": "Research",
"site": "northwind.dev/report",
"logo": "https://example.com/images/logo-northwind.png"
}
}'
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/stat-highlight.png?eyebrow=Research&label=of%20links%20shared%20on%20LinkedIn%20get%20more%20clicks%20with%20a%20custom%20preview%20image&site=northwind.dev%2Freport&source=Source%3A%20State%20of%20Social%20Previews%202026&value=87%25&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/stat-highlight/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)