thumbnail-creator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Thumbnail Creator

Generate professional YouTube thumbnails using AI. This skill connects to the Thumbnail Creator API to create thumbnails, analyze videos, manage creative assets, and generate SEO content.

使用AI生成专业的YouTube缩略图。本Skill对接Thumbnail Creator API，可创建缩略图、分析视频、管理创意资产并生成SEO内容。

Setup

配置步骤

Before using this skill, ensure you have:

A Thumbnail Creator account at https://app.thumbcraft.io
An API key from Settings → Developers → API Keys

使用本Skill前，请确保您已准备好：

在 https://app.thumbcraft.io 注册的Thumbnail Creator账号
从「设置 → 开发者 → API密钥」获取的API密钥

MCP Configuration (Recommended)

MCP配置（推荐）

Add to your Claude Desktop config (

~/Library/Application Support/Claude/claude_desktop_config.json

on macOS):

json

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

将以下内容添加到您的Claude Desktop配置文件中（macOS路径：

~/Library/Application Support/Claude/claude_desktop_config.json

）：

json

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

REST API

Base URL:

https://app.thumbcraft.io/api/v1

All requests require the header:

Authorization: Bearer YOUR_API_KEY

基础URL：

https://app.thumbcraft.io/api/v1

所有请求均需携带以下请求头：

Authorization: Bearer YOUR_API_KEY

Available Tools

可用工具

Thumbnail Generation

缩略图生成

generate_thumbnail

generate_thumbnail

Create a thumbnail from a text description.

Parameters:

```
prompt
```
(required): Detailed description of the thumbnail
```
youtube_url
```
(optional): YouTube URL for context
```
style_id
```
(optional): Apply a saved style
```
face_ids
```
(optional): Array of face IDs to include
```
brand_id
```
(optional): Brand ID for colors/logo
```
aspect_ratio
```
(optional): "16:9" (default) or "9:16"

Best practices for prompts:

Be specific about composition, colors, and emotions
Mention text overlays explicitly if needed
Describe the main subject's expression and pose
Include background details

Example:

Generate a thumbnail with a surprised man looking at a giant golden trophy.
Bold yellow text says "I WON". Dark gradient background with sparkles.
Photorealistic style, dramatic lighting.

根据文本描述生成缩略图。

参数：

```
prompt
```
（必填）：缩略图的详细描述
```
youtube_url
```
（可选）：用于获取上下文的YouTube视频链接
```
style_id
```
（可选）：应用已保存的风格
```
face_ids
```
（可选）：要包含的人脸ID数组
```
brand_id
```
（可选）：用于配色/Logo的品牌ID
```
aspect_ratio
```
（可选）：比例，默认"16:9"，可选"9:16"

提示词最佳实践：

明确说明构图、色彩和情绪
若需要文字叠加，请明确提及
描述主体的表情和姿势
包含背景细节

示例：

生成一张缩略图，画面中有一名惊讶的男子看着一个巨大的金色奖杯。
醒目的黄色文字写着“我赢了”。背景为深色渐变并带有闪光效果。
写实风格，戏剧性打光。

analyze_video

analyze_video

Analyze a YouTube video and get 5 thumbnail concepts with prompts.

Parameters:

```
youtube_url
```
(required): Full YouTube URL

Returns: Video summary and 5 thumbnail concepts with:

Title and description
Ready-to-use generation prompt
Emotional hook explanation

分析YouTube视频，提供5个带提示词的缩略图创意。

参数：

```
youtube_url
```
（必填）：完整的YouTube视频链接

**返回内容：**视频摘要及5个缩略图创意，每个创意包含：

标题和描述
可直接使用的生成提示词
情绪钩子说明

Asset Management

资产管理

list_faces

list_faces

Get uploaded face models for personalized thumbnails.

Parameters:

```
active_only
```
(optional): Only return trained faces

获取已上传的人脸模型，用于个性化缩略图。

参数：

```
active_only
```
（可选）：仅返回已训练完成的人脸

create_face

create_face

Create a new face from an image URL. Requires training before use.

Parameters:

```
name
```
(required): Display name
```
image_url
```
(required): Clear face photo URL

通过图片URL创建新的人脸模型，使用前需完成训练。

参数：

```
name
```
（必填）：显示名称
```
image_url
```
（必填）：清晰的人脸照片链接

list_styles

list_styles

Get saved thumbnail styles to apply to generations.

获取已保存的缩略图风格，可应用于生成任务。

list_brands

list_brands

Get brand assets (logos, colors) for consistent branding.

获取品牌资产（Logo、配色），确保品牌一致性。

list_thumbnails

list_thumbnails

Get recent generated thumbnails.

Parameters:

```
limit
```
(optional): Number to return (default: 10)

获取最近生成的缩略图。

参数：

```
limit
```
（可选）：返回数量（默认：10）

SEO Tools

SEO工具

generate_seo_titles

generate_seo_titles

Generate 10 SEO-optimized video titles from a YouTube URL.

Parameters:

```
youtube_url
```
(required): YouTube video URL

Returns: 10 titles with style labels:

Search-Driven (keyword-focused)
Curiosity/Viral (click-driving)
Authority/Expertise (trust-building)
Emotional/Story (connection)
Contrarian/Controversial (attention-grabbing)

根据YouTube视频链接生成10个SEO优化的视频标题。

参数：

```
youtube_url
```
（必填）：YouTube视频链接

**返回内容：**10个带风格标签的标题：

搜索导向（关键词聚焦）
好奇/ viral（吸引点击）
权威/专业（建立信任）
情感/故事（建立连接）
反向/争议（吸引注意力）

generate_seo_description

generate_seo_description

Generate a complete video description.

Parameters:

```
youtube_url
```
(required): YouTube video URL

Returns structured description with:

Hook (2 engaging sentences)
About This Video (150-200 word summary)
Key Takeaways (3-5 bullet points)
Timestamps/Chapters (6-10 sections)
Notable Quotes (1-2)
SEO Hashtags (3-5)

生成完整的视频描述。

参数：

```
youtube_url
```
（必填）：YouTube视频链接

返回结构化描述，包含：

钩子（2句吸引人的句子）
视频介绍（150-200字摘要）
核心要点（3-5个项目符号）
时间戳/章节（6-10个部分）
精彩语录（1-2条）
SEO标签（3-5个）

get_credits

get_credits

Check remaining credit balance.

查询剩余信用额度。

Workflows

工作流

Generate Thumbnail from YouTube Video

从YouTube视频生成缩略图

Call
```
analyze_video
```
with the YouTube URL
Present the 5 concepts to the user
Let user pick a concept or provide feedback
Call
```
generate_thumbnail
```
with the chosen concept's prompt
Optionally apply a style or include faces

调用
```
analyze_video
```
并传入YouTube视频链接
向用户展示5个创意选项
让用户选择创意或提供反馈
使用选中创意的提示词调用
```
generate_thumbnail
```
可选择性应用风格或添加人脸

Create Thumbnails with Consistent Style

创建风格一致的缩略图

Call
```
list_styles
```
to show available styles
Let user pick a style or describe a new one
Call
```
generate_thumbnail
```
with
```
style_id
```
parameter

调用
```
list_styles
```
展示可用风格
让用户选择风格或描述新风格
携带
```
style_id
```
参数调用
```
generate_thumbnail
```

Full YouTube Optimization

完整YouTube内容优化

Call
```
analyze_video
```
for thumbnail concepts
Generate thumbnail with
```
generate_thumbnail
```
Call
```
generate_seo_titles
```
for title options
Call
```
generate_seo_description
```
for the description
Present complete package: thumbnail + title + description

调用
```
analyze_video
```
获取缩略图创意
使用
```
generate_thumbnail
```
生成缩略图
调用
```
generate_seo_titles
```
获取标题选项
调用
```
generate_seo_description
```
生成描述
向用户展示完整套餐：缩略图+标题+描述

Tips for Best Results

最佳效果提示

Thumbnail Prompts

缩略图提示词

Be specific: "A woman with wide eyes and open mouth" > "surprised person"
Describe lighting: "dramatic side lighting", "soft natural light"
Mention style: "photorealistic", "3D rendered", "illustrated"
Include text carefully: Specify exact text, font style, and placement
Consider contrast: High contrast between subject and background

具体明确：“睁大眼睛、张开嘴巴的女性”优于“惊讶的人”
描述光线：“戏剧性侧光”、“柔和自然光”
提及风格：“写实”、“3D渲染”、“插画风格”
谨慎添加文字：明确指定文字内容、字体风格和位置
考虑对比度：主体与背景需有高对比度

Using Faces

人脸使用

Faces must be trained before use (check
```
trainingStatus
```
)
Use
```
face_ids
```
array to include multiple people
The AI will match the face to the described expression

人脸模型需训练完成后才能使用（查看
```
trainingStatus
```
）
使用
```
face_ids
```
数组可添加多个人脸
AI会将人脸与描述的表情匹配

Using Styles

风格使用

Styles capture visual aesthetics from reference images
Great for maintaining channel consistency
Combine with custom prompts for unique results

风格可从参考图中捕捉视觉美学
非常适合保持频道风格一致性
可结合自定义提示词获得独特效果

Error Handling

错误处理

Common errors:

```
401 Unauthorized
```
: Check API key
```
402 Payment Required
```
: Out of credits
```
429 Too Many Requests
```
: Rate limited, wait and retry
```
Invalid YouTube URL
```
: Ensure full URL format

常见错误：

```
401 Unauthorized
```
：检查API密钥
```
402 Payment Required
```
：信用额度不足
```
429 Too Many Requests
```
：请求超限，请稍后重试
```
Invalid YouTube URL
```
：确保链接格式完整

Credits

信用说明

Operations that consume credits:

```
generate_thumbnail
```
: 1 credit
All other operations: Free

Check balance with

get_credits

before generating.

消耗信用的操作：

```
generate_thumbnail
```
：1个信用点
其他所有操作：免费

生成前可调用

get_credits

查询余额。