Blog Featured Hero template

The blog-hero template renders a content image as a PNG. POST a JSON payload to the endpoint below and you receive a CDN URL in the response.

Endpoint

POST https://app.html2img.com/api/v1/templates/blog-hero
X-API-Key: <your-api-key>
Content-Type: application/json

Authentication uses the X-API-Key header. See the authentication docs for details on issuing and rotating keys.

Inputs

The full set of inputs the template accepts:

Defaults

Defaults applied automatically when not overridden in the request:

Code examples

curl -X POST https://app.html2img.com/api/v1/templates/blog-hero \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"The quiet rise of the small-team dev shop","subtitle":"Why eight-person studios are quietly outperforming the unicorn class.","category":"Industry","read_time":"7 min read","author_name":"Adaeze Okafor","author_role":"Editor at Northwind Weekly","author_avatar_url":"https://i.pravatar.cc/160?img=49","background_image_url":"https://picsum.photos/seed/blog-hero/1600/900","background_color":"#0F172A","accent_color":"#22D3EE"}'

<?php
$response = \Illuminate\Support\Facades\Http::withHeaders([
    'X-API-Key' => 'YOUR_API_KEY',
])->post('https://app.html2img.com/api/v1/templates/blog-hero', ['title' => 'The quiet rise of the small-team dev shop', 'subtitle' => 'Why eight-person studios are quietly outperforming the unicorn class.', 'category' => 'Industry', 'read_time' => '7 min read', 'author_name' => 'Adaeze Okafor', 'author_role' => 'Editor at Northwind Weekly', 'author_avatar_url' => 'https://i.pravatar.cc/160?img=49', 'background_image_url' => 'https://picsum.photos/seed/blog-hero/1600/900', 'background_color' => '#0F172A', 'accent_color' => '#22D3EE']);

$url = $response->json('url');

const response = await fetch('https://app.html2img.com/api/v1/templates/blog-hero', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "The quiet rise of the small-team dev shop",
    "subtitle": "Why eight-person studios are quietly outperforming the unicorn class.",
    "category": "Industry",
    "read_time": "7 min read",
    "author_name": "Adaeze Okafor",
    "author_role": "Editor at Northwind Weekly",
    "author_avatar_url": "https://i.pravatar.cc/160?img=49",
    "background_image_url": "https://picsum.photos/seed/blog-hero/1600/900",
    "background_color": "#0F172A",
    "accent_color": "#22D3EE"
}),
});

const { url } = await response.json();

import requests

response = requests.post(
    'https://app.html2img.com/api/v1/templates/blog-hero',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={'title': 'The quiet rise of the small-team dev shop', 'subtitle': 'Why eight-person studios are quietly outperforming the unicorn class.', 'category': 'Industry', 'read_time': '7 min read', 'author_name': 'Adaeze Okafor', 'author_role': 'Editor at Northwind Weekly', 'author_avatar_url': 'https://i.pravatar.cc/160?img=49', 'background_image_url': 'https://picsum.photos/seed/blog-hero/1600/900', 'background_color': '#0F172A', 'accent_color': '#22D3EE'},
)

url = response.json()['url']

Looking for a fuller integration sketch in your language? The usage guides cover PHP, Laravel, Rails, Python, JavaScript, React and Vue.

Response

A successful render returns:

{
 "success": true,
 "id": "abc123",
 "url": "https://i.html2img.com/abc123.png",
 "credits_remaining": 1234,
 "template": "blog-hero"
}

The url field is a CDN URL for the rendered PNG. credits_remaining tracks your monthly quota. Shared response fields are documented in the API parameters reference.

Errors

The template endpoint returns the following error responses:

422 Validation failed

Returned when one or more inputs fail validation. The errors object lists field-specific messages.

{
 "success": false,
 "error": "validation_failed",
 "errors": {
 "title": ["The title field is required."]
 }
}

404 Template not found

Returned with {"code": "template_not_found"} if the slug is not registered. Check the template list for current slugs.

401 Unauthorised

Missing or invalid API key. See the authentication docs.

429 Too many requests

You have hit the rate limit or used your monthly credits. The pricing page covers higher-volume plans.

Related templates

Other templates in the content and marketing category:

• Code screenshot - Beautiful syntax-highlighted code screenshots with window chrome
• Email header - Wide email banner artwork sized for newsletter and transactional templates
• GitHub social preview - Repo cards sized for GitHub social preview, share posts, and READMEs
• Open Graph image - Generate dynamic Open Graph images from JSON
• Podcast cover - Square cover artwork sized for Apple Podcasts, Spotify, and the major directories
• Podcast episode card - Per-episode share cards sized for Twitter, LinkedIn, and Slack unfurls
• Product card - E-commerce product cards with price, optional sale price, and CTA
• Project showcase - "We shipped X" hero cards for changelogs and launch announcements
• Quote card - Pull-quote cards for testimonials, reviews, and shareable quotes

Browse by category

A starting point from each of the other template categories. The templates index lists every reference page.

Social media: Facebook post , Instagram square post

Business and commerce: Business card , Certificate of completion

See the Blog Featured Hero marketing page for sample renders and use cases.