Video thumbnail OG image template

This is a real render from the API with the example values below, at 1200×630.

The look people already click on: a dark gradient over the frame, a huge title with a second line on a coloured band, the channel at the bottom and the duration in the corner. Use it for video pages, course trailers and social clips.

Fields

Every field is optional. Long text shrinks to fit instead of overflowing; an image field takes a public URL that we fetch on our side.

Render it with one request

Use the slug as template. The response holds the URL of the finished PNG; ?wait=true keeps the connection open until it is ready.

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

Or paste a signed URL into og:image

For static sites, Webflow, Shopify and no-code tools: put the fields in the query string and sign it with your signing secret. The first request renders the image, every later one is a redirect to the cached file. How to compute the signature.

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

Make it yours

accent and theme change per request. For anything more, copy the template into your account: you get an ordinary HTML template with the same fields that you can edit in the dashboard or through the API. If the slug is free on your account, the copy takes it — your integrations switch to your version without changing a line.

curl -X POST "https://imageapi.benchkithq.com/v1/templates/library/video-thumbnail/copy" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

More OG image templates

Blog post Job posting Event Podcast episode Changelog / release Documentation page Real estate listing Product card Product on sale Course lesson Recipe Newsletter issue Quote card Case study / testimonial GitHub repository Feature announcement Profile / author card Comparison (A vs B) Stat highlight

All templates →