ThumbnailGPT

ThumbnailGPT 帮助 YouTube 创作者使用 AI 生成专业且吸引眼球的缩略图。用户可以将视频创意、标题、脚本和参考图片转化为定制缩略图,使用人物参考保持面部特征一致,重现现有缩略图风格,并自定义场景、光线和构图。通过 MCP 集成,创作者无需切换工具,即可直接通过兼容的 AI 助手生成缩略图。

托管 MCP 服务器

npx add-mcp 'https://mcp.thumbnailgpt.com'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

ThumbnailGPT Developer & API Documentation

Official developer reference for ThumbnailGPT. CLI commands, Model Context Protocol (MCP) streamable endpoints, API keys, and SDK integration guides.

Canonical: https://thumbnailgpt.com/docs Last updated: 2026-11-05

The ThumbnailGPT Developer Platform enables developers, automation pipelines, and autonomous AI agents to generate, recreate, and edit YouTube thumbnails programmatically.

Quickstart

1. Generate an API Key

Create a Personal API Key with prefix tgpt_live_ in your Account Settings.

2. Run via CLI

# Zero-install one-off execution
npx -y thumbnailgpt generate --prompt "10 AI Tools That Will Replace You in 2026" --ratio 16:9

# Install globally
npm install -g thumbnailgpt
thumbnailgpt --version

Model Context Protocol (MCP) Configuration

ThumbnailGPT provides an official MCP server adhering to the Model Context Protocol specification.

  • Remote Streamable HTTP URL: https://mcp.thumbnailgpt.com
  • Local Stdio Command: npx -y thumbnailgpt mcp

Example Client Config (claude_desktop_config.json or Cursor mcp.json)

{
  "mcpServers": {
    "thumbnailgpt": {
      "url": "https://mcp.thumbnailgpt.com",
      "headers": {
        "Authorization": "Bearer tgpt_live_YOUR_API_KEY_HERE"
      }
    }
  }
}

Available MCP Tools

  • thumbnailgpt_generate: Generate a complete thumbnail from video concept, text, and aspect ratio (16:9 or 9:16).
  • thumbnailgpt_recreate: Recreate and remix an existing thumbnail from a public YouTube video URL or image link.
  • thumbnailgpt_edit: Apply conversational inpainting to adjust scene lighting, elements, or typography.
  • thumbnailgpt_list_personas: Fetch available creator character face profiles for consistent likeness.
  • thumbnailgpt_get_credits: Inspect account credit balance.

Related