ThumbAPI logoThumbAPI

Changelog

New features, improvements, and fixes for the ThumbAPI thumbnail generation API.

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+)