1
Send a JSON payload
POST to the template endpoint with the values you want rendered. Authenticate with your API key.
Twitter/X Post Image: Twitter Image Generator API
Generate share-ready images sized for Twitter/X posts
Use cases for the Twitter Image Generator API
The Twitter/X Post Image template is the shortest path to a working twitter image generator api from your stack. Send a small JSON payload, get back a tested PNG that fits your brand. No browser, no headless Chrome wrangling, no design tooling on your side.
Common reasons people reach for this template:
- Auto-generated share images for blog posts
- Launch announcement cards for X/Twitter
- Newsletter promotion graphics
How it works
2
We render the image
The template is rendered server-side as a 1200x630 PNG (or whatever dimensions the template defines).
3
You get back a URL
The response includes a CDN URL for the PNG. Cache it, embed it, attach it to a tweet, anything you need.
Quick example
A single cURL call to render a Twitter/X Post Image as a PNG:
curl -X POST https://app.html2img.com/api/v1/templates/twitter-post \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"We just shipped real-time collaboration","subtitle":"Edit docs together with sub-100ms latency, on every plan.","eyebrow":"PRODUCT UPDATE","author_name":"Acme Engineering","author_handle":"@acmeeng","author_avatar_url":"https://i.pravatar.cc/160?img=12","background_color":"#0B1220","accent_color":"#1D9BF0"}'For the full PHP, Node and Python equivalents, plus every input the template accepts, see the Twitter/X Post Image API reference. Setting up your key is covered in the authentication guide.
Inputs at a glance
A quick summary of what the Twitter/X Post Image template accepts. The full reference, including example values and array shapes, is in the docs.
| Name | Type | Required |
|---|---|---|
| title | string | Required |
| subtitle | string | Optional |
| eyebrow | string | Optional |
| author_name | string | Optional |
| author_handle | string | Optional |
| author_avatar_url | url | Optional |
| logo_url | url | Optional |
| background_color | string | Optional |
| accent_color | string | Optional |
See the full inputs reference for descriptions, examples and validation rules.
Related templates
Ready to render your first Twitter/X Post Image?
Sign up free, grab an API key, send a payload. The pricing page covers the higher-volume plans if you outgrow the free tier.