ThumbAPI Documentation
ThumbAPI is a REST API that generates production-ready thumbnails from any title. Send a title, pick a format, get an image — in under 30 seconds.
What You Can Build
- YouTube thumbnails (1280x720) from video titles
- OG images (1200x630) for blog posts and social sharing
- Instagram images (1080x1080) from content titles
- X/Twitter cards (1600x900) for social posts
Quick Overview
POST https://api.thumbapi.dev/v1/generate
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"title": "How to Build a SaaS in 2026",
"format": "youtube",
"imageStyle": "faceless"
}
The API returns a base64-encoded WebP image, the format used, and the output dimensions.
Getting Started
- Get your API key — free, no credit card
- Follow the quickstart — first thumbnail in 5 minutes
- Read the endpoint reference — every parameter explained
Available Formats
| Format | Dimensions | Use Case |
|---|---|---|
youtube | 1280 x 720 | YouTube video thumbnails |
blogpost | 1200 x 630 | Blog featured images, OG images |
instagram | 1080 x 1080 | Instagram post images |
x | 1600 x 900 | X/Twitter card images |
Image Styles
| Style | Description |
|---|---|
faceless | Text and graphic design, no people |
with-image | Includes a person's photo you provide |
with-logo | Branded thumbnail with your logo overlay |
Pricing
| Plan | Generations/month | Price |
|---|---|---|
| Free | 3 | $0 |
| Starter | 60 | $12/month |
| Pro | 300 | $29/month |
| Business | Unlimited | $150/month |
All plans include all formats and styles. View pricing →
Next Steps
- Quickstart guide — zero to first thumbnail
- Authentication — getting and using your API key
- Code examples — copy-paste snippets for cURL, JS, Python