Changelog
New features, improvements, and fixes for the ThumbAPI thumbnail generation API.
v1.2.0
MCP server, n8n community node, imageUrl in every response & dashboard upgrades
- Official MCP server — new
@thumbapi/mcp-serverexposes ThumbAPI as a native Model Context Protocol tool for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and Continue.dev. Setup guide. - Browser-based MCP login— say “log in to thumbapi” in your agent and the MCP server opens
app.thumbapi.dev/mcp-login, you consent, and the key lands in~/.thumbapi/config.json. No copy-paste, no env vars. One-click install links for Cursor and VS Code included. imageUrlin every successful generation response — a public Cloudflare R2 CDN link to the same file that's in the base64 payload. Use it to download, embed, or hand off to another tool without decoding. Additive change — clients that ignore it keep working unchanged.- n8n community node —
n8n-nodes-thumbapidrops a native ThumbAPI node into any n8n workflow. No more raw HTTP Request node wiring — parameter dropdowns, credential handling, and binary-image output all built in. - Library on the dashboard — every generation is archived automatically. Browse, filter (all / rated / failed), preview, download, rate, delete. Per-plan storage caps evict the oldest unpinned images automatically; rated items are protected.
- Integrations tab on the dashboard— dedicated one-page directory of every ThumbAPI integration (MCP, n8n, Zapier, Make, WordPress, GitHub Actions) with quick-copy install commands so you don't have to leave the app to wire something up.
- UX/UI pass — theme switcher, cleaner Assets tab, tightened logs modal, unified consent screens across signup / promo claim / MCP login, and dozens of small copy/layout fixes.
v1.1.0
Independent assets, categories, 1K/2K quality & more
- New params: `usePhoto` and `useLogo` are independent boolean flags — combine them on the same request (face + branded corner) or use either alone. The legacy `imageStyle` enum still works.
- New params: `photoImage` (max 2MB) and `logoImage` (max 1MB) accept inline base64 separately, replacing the single `personImage` field.
- 13 content categories — `auto`, `tech-saas`, `business-finance`, `education-tutorial`, `fitness-wellness`, `medical-healthcare`, `lifestyle-vlog`, `food-cooking`, `travel`, `gaming`, `entertainment-comedy`, `news-commentary`, `creative-design`. Biases reference search and final tone toward the niche without overriding your references.
- New quality parameter — `1K` (default) or `2K` (Pro+ only). Switch per request to balance cost against sharpness.
- LinkedIn format added (1200×627 — professional feed card with no text overlay).
- Instagram output is now square 1024×1024.
- Custom logo positioning: drag, resize (5–30% of canvas width), and toggle drop shadow on saved logos. Position stored as a 0–1 fraction so the same coords work across every format.
- Reference sets now remember the format they were built for — selecting one in the playground auto-locks the output format so you can't generate a mismatched aspect by accident.
- Native aspect-ratio generation — the model renders directly at the target ratio instead of upscaling from 16:9 (cleaner output for square and portrait formats).
- Test API key `thumbapi_test` — returns a static 200 OK image instantly without consuming quota, for integration smoke tests.
- Official WordPress plugin is now live on the WordPress.org Plugin Directory — install with one click from your WP admin, or visit wordpress.org/plugins/thumbapi.
v1.0.0
Public Beta Launch
- POST /v1/generate endpoint — generate thumbnails from any title
- 4 formats: YouTube (1280x720), Blog/OG (1200x630), Instagram (1080x1080), X (1200x675)
- 3 image styles: faceless, with-image, with-logo
- API key authentication via x-api-key header
- Free tier: 50 credits/month
- Creator ($19/mo), Pro ($49/mo), and Business ($199/mo) plans available
- WebP output with base64 encoding
- JavaScript and Python SDK (beta)
- Webhook support for async generation (Pro+)