Branded Thumbnails — Your Logo on Every Image, Generated by API

ThumbAPI generates thumbnails with your company or channel logo built into the design. Set useLogo: trueand get a branded thumbnail that maintains your visual identity across every piece of content.

Consistent branding at scale. No design team needed. One API call per thumbnail.

Upload your logo once as an asset in your ThumbAPI dashboard — then every request just needs useLogo: true. No base64 encoding, no file handling in your code. Your logo stays in your account, ready to use.

How It Works

Option A — Use a saved asset (recommended)

Upload your logo once in the ThumbAPI dashboard under Assets → Logo. Then every API call just needs useLogo: true. PNG with transparent background works best.

1. Save your logo — upload it once in Assets (PNG or SVG, max 2MB, transparency recommended)
2. Generate thumbnails — set useLogo: true in every request
3. Done — the API places your logo in a visually balanced position on every thumbnail

curl -X POST https://api.thumbapi.dev/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How We Scaled to 1M Users",
    "format": "blogpost",
    "useLogo": true
  }'

Option B — Send inline base64

You can also send the logo as base64 in the logoImage field (max 1MB) on every request. Useful if you manage multiple brands or need different logos per request.

curl -X POST https://api.thumbapi.dev/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How We Scaled to 1M Users",
    "format": "blogpost",
    "useLogo": true,
    "logoImage": "data:image/png;base64,iVBORw0KGgo..."
  }'

API Parameters

Why Brand Consistency Matters

Viewers scroll through hundreds of thumbnails per session. A consistent logo placement, color scheme, and visual style makes your content recognizable at a glance — before reading a single word. Over time, your branded thumbnails become a trust signal. People click because they recognize the brand and trust the quality behind it.

Reference Images — Consistent Style Across All Thumbnails

Go beyond just adding a logo. Upload 1-6 reference thumbnails as a reference set in your Assets. These serve as a style dataset — the AI uses them as inspiration for layout, color palette, and visual composition.

Create a reference set in your dashboard, then pass its ID as customAssetsId in your API request. Combined with useLogo: true, every thumbnail matches your brand style and carries your logo.

Who Uses Branded Thumbnails

• Companies with YouTube channels — every video carries the brand, not just the creator's face.
• SaaS products — tutorial videos, product updates, and webinar recordings all get branded covers.
• Media companies — multiple shows or series under one brand umbrella, each with consistent branding.
• Agencies — manage multiple client brands, each with their own logo in every thumbnail.
• Blogs and newsletters — branded cover images for every post, automatically generated from the title.

Logo Best Practices

• Format: PNG with transparent background. Avoid JPEG (no transparency).
• Size: At least 200x200px for clarity. The API scales it to fit the design.
• Simplicity: Simple logos work better at thumbnail scale. Wordmarks may be too small to read.
• Contrast: Ensure your logo is visible against both light and dark backgrounds.

Personalized vs Faceless vs Branded

FAQ

What logo formats are accepted?

PNG with transparent background works best. JPEG works but won't have transparency. Max 2MB.

Do I need to send my logo on every request?

No. Save your logo once as an asset in the dashboard, then use useLogo: true on every request. The API pulls it from your account automatically.

Can I use different logos for different brands?

Your saved asset holds one logo. For multi-brand use cases, send the logo inline via logoImage on a per-request basis.

Can I control where the logo appears?

The AI automatically places the logo in a visually balanced position based on the thumbnail design. The placement adapts to each generated image.