Public Beta — reserve early accessJoin Waitlist
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",
  imageStyle: "faceless",
});

console.log(result.image);       // base64 WebP
console.log(result.dimensions);  // { width: 1280, height: 720 }

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",
    image_style="faceless",
)

print(result.image)       # base64 WebP
print(result.dimensions)  # {"width": 1280, "height": 720}

Features

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

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

Edit on GitHub