Thumbnail API for Creators — Every Thumbnail in Your Stack, Generated by API
A working creator ships to more surfaces every year. A YouTube upload needs a 1280×720. A Shorts drop needs a 16:9 hero. A tweet thread needs a 1200×675 in-post card and a 1200×630 link card. An Instagram post needs 1024×1024. A LinkedIn cross-post needs 1200×627. A newsletter or blog needs a 1200×630 OG image. Manually that's 30–90 minutes of design per video release. The thumbnail API for creators replaces that with one endpoint and a format parameter.
This is not a design tool. There's no editor, no template library, no drag-and-drop canvas. It's a REST call: send a title, pick a format, get back a production-ready image. Every creator workflow that ships more than a few pieces per week hits the same conclusion — the design step is the bottleneck, not the content — and the fix is automation, not a faster editor.
Stop designing thumbnails. Start shipping them.
Get Your Free API KeyThe whole thing, in one call
curl -X POST https://api.thumbapi.dev/v1/generate \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "The Faceless YouTube Playbook — Full Walkthrough",
"format": "youtube",
"useLogo": true
}'Every Creator Format, One Endpoint
| Format | Size | Where it goes | Dedicated hub |
|---|---|---|---|
youtube | 1280×720 | YouTube video thumbnails, Shorts hero | YouTube Thumbnail API |
blogpost | 1200×630 | OG images, blog covers, X link cards | OG Image API |
x | 1200×675 | X (Twitter) in-post images and video thumbnails | Twitter Thumbnail API |
instagram | 1024×1024 | Instagram feed posts, reels covers | Instagram Post Images |
linkedin | 1200×627 | LinkedIn feed posts and article hero banners | LinkedIn Post Image API |
What Creators Actually Do With It
- Auto-thumbnail every new video. Publish trigger → POST title → attach the returned image to the upload. Full automated flow — see the YouTube automation channel walkthrough for the batch-scale version.
- Ship faceless channels at scale. Default (no flags) output is a text-and-graphic composition ready for compilation, listicle, and AI-narrated content. The faceless channel automation guide covers the full pipeline.
- Cross-post visuals in every format. One title, five format calls, five sized-and-composed images. Every platform gets a native-shaped card without a designer.
- A/B test winners into defaults.Generate 3 variants, put them into YouTube's Test & Compare, feed the winning style back into a reference set. The thumbnail A/B testing playbook covers the loop.
- Blog and newsletter covers. Every post gets a unique 1200×630 OG image. See the automated blog covers walkthrough for the CMS webhook shape.
Faceless, Personalized, or Branded — Three Styles
| Style | Parameter | Best for |
|---|---|---|
| Faceless | (default — no flags) | Compilation, listicle, education, AI-narrated channels |
| Personalized | usePhoto: true | Creator-led channels, podcasts, personality-first content |
| Branded | useLogo: true | Multi-show brands, agencies, SaaS content channels |
| Both | usePhoto: true, useLogo: true | Personal brands that want face + channel mark |
How It Fits a Creator's Existing Stack
- No-code automation. Zapier, Make, and n8n all wire it into publishing flows without a developer.
- Publish scripts. Any script that hits the YouTube Data API, WordPress REST API, Ghost Admin API, or a headless CMS can generate the thumbnail inline and upload it in the same run.
- LLM agents (MCP). The public ThumbAPI MCP server lets Claude, Cursor, and other agents generate thumbnails directly — useful for AI-driven content pipelines.
- WordPress. A dedicated WordPress integration hooks the publish action for creators on WP.
Pricing
Metered in credits. A standard creator thumbnail costs 10 credits. Add-ons (saved photo, saved logo, custom reference set) add +2 each. A 2K render costs 20 credits.
| Plan | Credits / month | Approx creator videos / month | Price |
|---|---|---|---|
| Free | 50 | 5 | $0 |
| Creator | 750 | 75 | $19/month |
| Pro | 2,500 | 250 | $49/month |
| Business | 10,000 | 1,000 | $199/month |
Solo creators (2–5 videos a week) land on Creator ($19/mo). Small multi-channel agencies land on Pro ($49/mo). YouTube automation studios shipping 30+ videos a day land on Business ($199/mo) with room for cross-platform cross-posting. Full pricing breakdown.
FAQ
Is this different from the developer-facing Thumbnail API?
Same API, framed for creator workflows. The endpoint is REST — anything that can make an HTTP request works, including no-code tools like Zapier, Make, and n8n. If you're a developer, the /thumbnail-api umbrella page has the technical framing.
What creator formats are supported?
Five named formats: youtube (1280×720), blogpost (1200×630 for OG images and blog covers), x (1200×675 for X/Twitter posts and Shorts-style 16:9), instagram (1024×1024 square), and linkedin (1200×627). One endpoint covers every surface creators publish to.
Can I keep my brand style consistent across every thumbnail?
Yes. Upload 1–6 of your best-performing past thumbnails as a custom reference set on Pro or Business, and pass customAssetsId per request. Every generation inherits your visual style — palette, composition, typography. Combined with useLogo: true, every thumbnail carries your channel mark.
Does the free tier have a watermark?
Yes — free tier output has a small ThumbAPI watermark for evaluation. Paid plans (Creator onward, $19/mo) return watermark-free images.
Can I A/B test thumbnails?
Yes — generate 2–3 variants per video with different flags (usePhoto, useLogo, category, or different customAssetsId) and upload them to YouTube's Test & Compare. The thumbnail A/B testing playbook covers the sample-size math and how to design a test that produces signal.
Does it work with faceless channels?
Yes — default output (no flags) is a text-and-graphic composition with no people, tuned for compilation, listicle, educational, and AI-narrated channels. See the faceless channel automation walkthrough for the full end-to-end pipeline.
One API key. Every format. Every video. Every post.
Start Free — 50 Credits/MonthRelated Pages
The developer-facing umbrella. Same endpoint, technical framing.
YouTube Thumbnail APIFormat-focused hub for YouTube 1280×720 thumbnails.
OG Image API1200×630 OG cards for blogs, newsletters, and share previews.
Faceless Channel AutomationFull pipeline for compilation, listicle, and AI-narrated channels.
YouTube Automation ChannelScale to 1000 videos — batch generation + upload workflow.
Bulk Thumbnail GenerationBatch script for 100–10,000 titles at once.
Thumbnail A/B TestingSample-size math and Test & Compare loop for creators.
QuickstartGet a key, make your first call, see the response shape.