Dish name in a serif face, cooking time, servings and difficulty next to a round photo.
This is a real render from the API with the example values below, at 1200×630.
Recipes are shared on Pinterest, Facebook and WhatsApp more than almost anything else. Warm paper colours, a serif title and the dish on a round plate make the card look like a cookbook page, not like software.
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.
| Field | Type | Description | Example |
|---|---|---|---|
title |
text | Name of the dish. default: Recipe name | Crispy tofu bowl with sesame-lime dressing |
category |
text | Small label above the title, e.g. the course or category. | Weeknight dinner |
time |
text | Total cooking time. | 35 min |
servings |
text | Number of servings. | 4 servings |
difficulty |
text | Difficulty, e.g. Easy. | Easy |
author |
text | Byline, e.g. by Green Pantry. | by Green Pantry |
site |
text | Your domain or a short URL. | greenpantry.co |
photo |
image URL | Photo of the dish, ideally shot from above. | https://example.com/images/salad.jpg |
accent |
colour | Brand colour as hex, e.g. #6366f1. Drives buttons, highlights and the background glow. default: #c2410c | #c2410c |
theme |
dark | light | Colour scheme: dark or light. default: light | — |
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": "recipe",
"modifications": {
"title": "Crispy tofu bowl with sesame-lime dressing",
"category": "Weeknight dinner",
"time": "35 min",
"servings": "4 servings",
"difficulty": "Easy",
"author": "by Green Pantry",
"site": "greenpantry.co",
"photo": "https://example.com/images/salad.jpg"
}
}'
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/recipe.png?author=by%20Green%20Pantry&category=Weeknight%20dinner&difficulty=Easy&servings=4%20servings&site=greenpantry.co&time=35%20min&title=Crispy%20tofu%20bowl%20with%20sesame-lime%20dressing&s=YOUR_SIGNATURE">
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/recipe/copy" \
-H "Authorization: Bearer sk_live_YOUR_KEY"
Blog post
Job posting
Event
Podcast episode
Changelog / release
Documentation page
Real estate listing
Product card
Product on sale
Course lesson
Newsletter issue
Quote card
Case study / testimonial
GitHub repository
Feature announcement
Profile / author card
Comparison (A vs B)
Stat highlight