ThumbAPI logoThumbAPI

SDKs

Official client libraries for ThumbAPI. These are thin wrappers around the REST API — you can always use the API directly with fetch or requests.

JavaScript / Node.js

npm install thumbapi

import { ThumbAPI } from "thumbapi";

const client = new ThumbAPI(process.env.THUMBAPI_KEY);

const result = await client.generate({
  title: "10 Tips to Grow Your Channel",
  format: "youtube",
  category: "education-tutorial",
  usePhoto: true, // optional — overlay your saved photo
});

console.log(result.image);        // base64 WebP
console.log(result.outputFormat); // "webp" | "png"

Features

  • TypeScript types included
  • Automatic retry with exponential backoff
  • Configurable timeout
  • ESM and CJS support

Python

pip install thumbapi

from thumbapi import ThumbAPI

client = ThumbAPI(api_key=os.environ["THUMBAPI_KEY"])

result = client.generate(
    title="10 Tips to Grow Your Channel",
    format="youtube",
    category="education-tutorial",
    use_photo=True,  # optional — overlay your saved photo
)

print(result.image)         # base64 WebP
print(result.output_format) # "webp" | "png"

Features

  • Type hints included
  • Automatic retry with backoff
  • Sync and async support (AsyncThumbAPI)
  • Python 3.8+

Prefer raw HTTP with requests or httpx? The Python thumbnail API tutorial walks through sync, async, retries, and FastAPI/Flask integration without the SDK.

Direct API Usage

Don't want a library? The API is a single POST endpoint. See the quickstart for raw curl, fetch, and requests examples.

Coming Soon

  • Go SDK
  • Ruby SDK
  • PHP SDK

Request an SDK →

Next Steps