Send title and CTA as JSON, get back a 1080x1920 vertical PNG sized for Stories.
Brand teams and short-form video producers use the Instagram Story image generator API to ship 9:16 vertical covers for Stories, Reels covers, and TikTok holding cards. The 1080x1920 output respects Instagram's safe zones, with the title placed inside the central area that survives both the top profile bubble and the bottom sticker tray. You post the title, optional eyebrow, optional CTA, and brand inputs as JSON, and the response holds a PNG ready to publish via the Graph API or schedule with Buffer.
curl -X POST https://app.html2img.com/api/v1/templates/instagram-story \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Behind the scenes","subtitle":"How our team built the v3 release in six weeks.","eyebrow":"NEW EPISODE","cta":"Swipe up","background_image_url":"https://picsum.photos/seed/insta-story/1080/1920","background_color":"#0F0F1A","accent_color":"#FACC15"}'
A single cURL call to render a Instagram Story as a PNG. Add "format": "pdf" to the payload to get a PDF instead. For the full PHP, Node and Python equivalents, plus every input the template accepts, see the
Instagram Story API reference.
Setting up your key is covered in the
authentication guide.
View the Instagram Story API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.
Stores launching a new SKU benefit from a Story cover that drops on launch day, alongside the feed post. Render with the product name, price, and a CTA to swipe up, schedule via Meta Business Suite, and the launch reaches both feed and Stories surfaces with consistent branding. Riverside Bakery launches 3 to 4 product Stories per month through this template.
Communities running monthly events post Story countdowns in the days before each date. Render with "3 days to go", the event title, and the venue or join link, post on the calendar dates, and the Story keeps the event present without flooding the feed. The Type Conference posts countdown Stories for 7 days before the event using this template.
Show producers post a Story per episode to push subscribers to the new drop. Render with the episode number, title, and a CTA, post on the morning of the release, and the Story keeps the show top-of-mind for the 24 hours it stays visible. Halberd Software's podcast publishes one Story per Tuesday episode and gets 200 to 400 swipe-ups per launch.
News teams use Stories to surface breaking news quickly. Render with the headline and a "Tap for more" CTA, post the moment a story breaks, and the audience sees the news in their Story tray within minutes. Linden & Co's regional news clients run this pattern across 11 stations for breaking-news coverage.
Companies with a private team Instagram account post updates to a Story that stays visible for 24 hours. Render with the update title, accent_color from your brand kit, and post via the Graph API. Wren Analytics uses this for "Friday wins" Stories that surface team accomplishments without flooding the public feed.
Matches the spec at Instagram Stories format and safe zones.
These specifications describe the default PNG output. The template can also return a PDF document with selectable text through the HTML to PDF API: set format to pdf in the request. See the format parameter docs for how PDF output behaves.
POST to the template endpoint with the values you want rendered. Authenticate with your API key.
The template is rendered server-side as a 1080x1920 PNG, or as a PDF document if you set format to pdf.
Cache it, embed it in your page, attach it to an email.
Instagram places the profile bubble in the top 250 pixels and reaction stickers in the bottom 250 pixels. Important content placed in those zones gets covered. Keep the focal area between y=250 and y=1670 so the title and brand mark survive the UI overlays.
When you add a link sticker via Instagram's editor, it lands wherever the user drops it and may cover content. Reserve a clean area in the lower third of the safe zone where the link sticker can land without obscuring the title.
A "Swipe up" CTA in the bottom band conflicts with Instagram's native swipe indicator. Either rely on Instagram's native CTA and remove your custom one, or position the custom CTA above the bottom 300 pixels.
A quick summary of what the Instagram Story template accepts. The full reference, with example values and array shapes, is in the docs.
| Name | Type | Required |
|---|---|---|
title | string | Required |
subtitle | string | Optional |
eyebrow | string | Optional |
cta | string | Optional |
background_image_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.
Other templates in the social media category.
Bold share images sized for Facebook feed posts
Bold square images sized for the Instagram feed
Polished share images sized for LinkedIn feed posts
Vertical 2:3 pins with strong typography that stand out in feed
Render a tweet-style card from supplied data — avatar, body, image, metrics
Generate share-ready images sized for Twitter/X posts
High-contrast 16:9 thumbnails optimized for click-through
A starting point from each of the other two template categories.
See the full template gallery for every design grouped by category.
What size is an Instagram Story?
The 1080x1920 PNG output (9:16 vertical) matches the Instagram Stories spec. The same dimensions also work for Facebook Stories, TikTok, YouTube Shorts cover, and Snapchat. The template renders this size by default.
Where are the safe zones?
Keep important content between y=250 and y=1670. The top 250 pixels host the profile bubble, follow button, and timing dots. The bottom 250 pixels host the reply input and reactions. Content outside those bounds gets covered by Instagram UI on most devices.
Can I add a link sticker visual?
The link sticker is added inside Instagram's editor when you publish, not on the image itself. Leave space in the lower portion of the safe zone for the sticker to land. The sticker color and shape come from Instagram, not from your render.
Will it work for Reels covers?
Yes, Reels covers use the same 1080x1920 dimensions as Stories. You can use this template's output as a Reels cover by selecting it as the cover image when publishing the Reel. The same render serves both surfaces.
Can I auto-post to Stories?
Yes, the Instagram Graph API supports Stories posting from connected Business or Creator accounts. This template produces the artwork only. Most teams render in advance, store the URLs, and queue posts via Buffer, Later, or a custom scheduler.
What about Story Highlights?
Highlight covers are 1080x1920 cropped to a circle by Instagram's UI. Design with a centered subject so the circular crop frames it correctly. The same render works for both ephemeral Stories and persistent Highlight covers.
25 renders a month on the free tier. See the pricing page for higher-volume plans.