API Overview

The YT AI Thumbnail API provides programmatic access to all features of the platform, enabling you to integrate AI-powered thumbnail generation into your own applications and workflows.

MCP Server for AI Agents

New: Use our API with AI assistants like Claude! Our MCP (Model Context Protocol) server enables AI agents to generate thumbnails, analyze videos, and manage your resources through natural conversation.

{
  "mcpServers": {
    "yt-ai-thumbnail": {
      "url": "https://app.thumbcraft.io/api/mcp",
      "headers": {
        "Authorization": "Bearer api_your_key_here"
      }
    }
  }
}

Set up MCP integration →

Features

• Thumbnail Generation - Generate AI thumbnails from prompts, with support for styles, brands, faces, and reference images
• Thumbnail Editing - Edit existing images with AI: general edits, face swap, background removal/replacement, color enhancement, upscaling, filters, and image combining
• Thumbnail Utilities - Critique thumbnails with AI scoring, optimize rough ideas into viral prompts, get text overlay suggestions, and extract YouTube thumbnails
• Video Analysis - Analyze YouTube videos to get thumbnail concept suggestions
• Style Management - Create and manage thumbnail styles from reference images
• Face Management - Upload and manage face models for personalized thumbnails
• Brand Management - Import brand colors and assets from domains
• Collections - Organize thumbnails into collections
• SEO Tools - Generate optimized titles and descriptions for YouTube videos
• MCP Server - Integrate with AI agents via Model Context Protocol

Base URL

All API requests should be made to:

https://yourdomain.com/api/v1

Interactive Documentation

For a full interactive API reference with the ability to test endpoints, visit:

Interactive API Documentation →

Getting Started

1. Create an API Key from your dashboard
2. Make your first request
3. Explore the endpoints

Rate Limits

Rate limits are enforced per API key based on your subscription tier:

Rate limit headers are included in all responses:

• X-RateLimit-Limit - Maximum requests per window
• X-RateLimit-Remaining - Remaining requests in current window
• X-RateLimit-Reset - Unix timestamp when the window resets

Credits

Some operations consume credits:

Other operations (listing, reading, creating styles/faces/brands) do not consume credits.