- name
- generate-image
- description
- Generate a PNG image from HTML content or a public URL using headless Chromium. Supports custom dimensions, retina quality, full-page screenshots, cookie consent handling, and dynamic parameters.
Generate Image
What It Does
Renders a webpage or HTML content to a PNG image using headless Chromium. Supports URL screenshots and HTML-to-image rendering with full customization.
When to Use
- Take a screenshot of a live webpage
- Render HTML/CSS to a PNG image (social cards, banners, certificates)
- Generate full-page scrollable screenshots
- Create retina-quality images with custom dimensions
Required Inputs
You must provide one of:
html_content— raw HTML string to renderurl— a public URL to screenshot
Authentication
Send your API key in the CLIENT-API-KEY header.
Get your free API key at https://pdfapihub.com. Full API documentation is available at https://pdfapihub.com/docs.
Use Cases
- Social Media Cards — Generate OG images, Twitter cards, or Instagram story images from HTML templates
- Email Banners — Create personalized email header images with dynamic content
- Website Screenshots — Capture full-page or viewport screenshots of live websites for monitoring or previews
- Certificate Images — Render certificates as PNG images for sharing on social media
- Product Mockups — Generate product images with dynamic text overlays
- Thumbnail Generation — Create consistent thumbnail images for blog posts or video previews
- QR Code Cards — Render HTML with embedded QR codes as shareable images
Key Options
| Parameter | Description |
|---|---|
output_format | url (default), base64, both, image/png/binary/file |
width / height | Output image dimensions in pixels |
deviceScaleFactor | 1 (default), 2 for retina quality |
full_page | true for full scrollable screenshot (URL mode) |
wait_until | load, domcontentloaded, networkidle, commit |
cookie_accept_text | Auto-click cookie consent before screenshot |
font | Google Font names, pipe-separated |
dynamic_params | Key-value object for {{placeholder}} replacement |
Rate Limits
| Tier | Requests/min |
|---|---|
| Free/Basic/Pro | 10 |
| Enterprise | 30 |
| Business | 100 |
Example Usage
curl -X POST https://pdfapihub.com/api/v1/generateImage \
-H "CLIENT-API-KEY: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"html_content": "<div style=\"padding:40px;background:#4F46E5;color:white;\"><h1>Hello {{name}}</h1></div>",
"dynamic_params": { "name": "World" },
"width": 800,
"height": 400,
"output_format": "url"
}'Notes
- Files are automatically deleted after 30 days
- Maximum output file size depends on your plan tier