n8n community node for ThumbAPI — generate platform-ready thumbnails for YouTube, Instagram, X / Twitter, blog posts, and LinkedIn from a title in a single API call.
Installation · Operations · Credentials · Example workflow · Resources
Send a title, get back a finished thumbnail. No template design, no SDK lock-in, no manual editing. The node:
- Outputs to YouTube (1280×720), Instagram (1024×1024), X (1200×675), blog post (1200×630), LinkedIn (1200×627)
- Supports personal photo overlay (face in the scene) and logo overlay (brand in the corner) — saved once in the dashboard, used by reference
- Supports custom reference datasets for brand-consistent style across content
- Returns the image either as a base64 data URI in JSON or as n8n binary data ready to be saved, uploaded, or piped into the next node
- Open n8n → Settings → Community Nodes
- Click Install
- Enter
n8n-nodes-thumbapi - Accept the risks notice → Install
The ThumbAPI node will appear in the nodes panel.
npm install n8n-nodes-thumbapiThen restart n8n.
The fastest way to verify the node works in your workflow:
- Drop the ThumbAPI node onto a canvas
- Enable the Use Public Test Key toggle at the top
- Set a Title (anything), pick a Format
- Click Execute step
You'll get a placeholder thumbnail back in under 2 seconds. No credential, no signup, no credit consumption. Use this to wire your workflow end-to-end, then plug in a real key when you're ready to generate real thumbnails.
You need a ThumbAPI account and an API key.
- Sign up at thumbapi.dev — the free tier gives you 50 credits per month, no credit card required
- Copy your key from the dashboard (looks like
tb_live_abc123...) - In n8n, create a new ThumbAPI API credential and paste the key
Use the public test key thumbapi_test to verify the integration. It returns a static placeholder image and does not consume credits.
Calls POST https://api.thumbapi.dev/v1/generate.
| Field | Required | Notes |
|---|---|---|
| Title | Yes | The text on the thumbnail. Max 200 chars. |
| Format | Yes (*) | youtube, instagram, x, blogpost, linkedin. Ignored when Custom Assets ID is set. |
| Category | No | Niche bias (tech-saas, business-finance, education-tutorial, etc.). Default auto. |
| Model (Quality) | No | sd = 1K (10 credits, default), hd = 2K (20 credits, Pro+ plans). |
| Output Format | No | webp (default) or png. |
| Use Saved Photo | No | Include your saved Personal Photo as main subject. +2 credits. |
| Use Saved Logo | No | Overlay your saved Logo in the corner. +2 credits. |
| Custom Assets ID | No | ID of a saved reference dataset. Style is cloned at 80–100% fidelity. +2 credits. |
| Inline Photo / Logo | No | Override saved assets with a per-request base64 image. |
| Put Output In Binary | No | When on (default), the returned image is decoded and attached as binary data on the output item under the configured property name. |
| Operation | Credits |
|---|---|
Base 1K render (sd) |
10 |
Base 2K render (hd, Pro+) |
20 |
usePhoto add-on |
+2 |
useLogo add-on |
+2 |
customAssetsId add-on |
+2 |
Full reference: ThumbAPI docs — Generate endpoint.
A typical content automation pipeline:
Trigger (RSS / Airtable / Webhook)
↓
ThumbAPI: Generate (title = "{{ $json.title }}", format = "youtube")
↓
Google Drive: Upload binary data
↓
YouTube: Update video thumbnail (or Slack notify, etc.)
The node emits binary.data by default, so any downstream node that accepts binary (Drive, S3, HTTP upload, Email attachment, YouTube thumbnail update) just works.
- Start with
format: youtubeand thethumbapi_testkey to wire your workflow without burning credits. - Save your Personal Photo and Logo once in the ThumbAPI dashboard so you can toggle
usePhoto/useLogofrom the node without sending base64 every time. - For brand-consistent series, build a Reference Dataset in the dashboard and pass its ID via Custom Assets ID — the AI will mirror your visual style at 80–100% fidelity.
- The 2K (
hd) render is gated to Pro and Business plans; on lower plans the API returns403 UPGRADE_REQUIRED.