Developer API

Welcome to the YouThumbAI Developer API. This REST API allows you to integrate AI-powered thumbnail generation directly into your applications, automate workflows, and build custom integrations.

Base URL

All API requests are made to: 
https://youthumb.ai/api

Getting Your API Key

To use the API, you need an API key. Here's how to get one:
1

Navigate to API Keys

Go to Account → API Keys
2

Create New Key

Click the Create API Key button and give your key a descriptive name.
3

Copy Your Key

Copy your API key immediately. For security reasons, it will only be shown once.
Security Warning: Never expose your API key in client-side code, public repositories, or browser JavaScript. Always use environment variables and server-side requests.

Quick Start

Here's a minimal example to create and generate a thumbnail: 
# 1. Create a thumbnail project
curl -X POST https://youthumb.ai/api/thumbnails \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Excited creator with bright yellow background"}'

# Response: { "success": true, "data": { "projectId": "abc-123", ... } }

# 2. Start generation
curl -X POST https://youthumb.ai/api/thumbnails/abc-123/start \
  -H "x-api-key: your_api_key"

# 3. Poll for completion
curl https://youthumb.ai/api/thumbnails/abc-123/status \
  -H "x-api-key: your_api_key"

Response Format

All API responses follow a consistent format: Success Response: 
{
  "success": true,
  "data": { ... }
}
Error Response: 
{
  "success": false,
  "error": "Error message",
  "details": { ... }  // Optional: validation errors
}

Available APIs

APIDescription
ThumbnailsCreate and generate AI thumbnails
PersonsManage face profiles for personalization
TemplatesBrowse style reference templates
PresetsAccess predefined style presets
AssetsUpload and manage images (faces, templates, temp files)

Rate Limits

API requests are rate-limited based on your subscription plan. If you exceed the limit, you'll receive a 429 Too Many Requests response.

What's Next?

1

Authentication

Learn about authentication methods and best practices.
2

Thumbnails API

Explore the Thumbnails API to start generating thumbnails.
Need help? Contact our support team or check the error codes reference for troubleshooting.