YouTube 缩略图制作

技能文档

---
name: youtube-thumbnail-maker
title: YouTube 缩略图制作
category: 内容创作
description: 使用 AI 将 YouTube 选题、标题、脚本、关键帧、人物照、商品图或频道参考制作成缩略图封面，规划视觉钩子、清晰层级、标题匹配建议与标题安全区，并支持精修为统一的频道视觉。当用户需要制作 YouTube 封面、油管缩略图、长视频封面等场景时触发。
---

# YouTube视频缩略图制作

把选题、标题、关键帧、人物照、商品图或频道参考，做成一张主体明确、层级清楚、并给标题留出
位置的 YouTube 缩略图。同时给出标题匹配建议，以及一条能让下一张一眼看出是同一个频道的规则。

渲染在 Beatra 上进行，因此本 Skill 需要一个有积分的 beatra.ai 账号。任何要访问 Beatra 的
步骤都需要先完成安装连接：未连接的安装会停下并提示 `scripts/authorize.py`，运行它会在浏览
器里打开 Beatra 授权页，用户在那里登录或注册账号；已经连接过 Beatra 的安装会跳过这一步。
只有渲染会计费，调用前会按实时模型卡展示当前价格和最高费用供确认。任务结算按实测用量计费，
因此把这个数字当作确认依据，而不是最终金额的保证。

## 适用范围与路线选择

长视频的 YouTube 缩略图都适用本 Skill：候选方向、标题与封面的搭配，以及整个频道在多期之间
的视觉方向。

相邻的活儿由其他 Beatra Skill 负责。对应的 Skill 已安装时：B站封面请使用
`bilibili-thumbnail-maker`；诊断用户手上已有的封面请使用 `cover-performance-preflight`；
通用宣传物料请使用 `poster-design-studio`；小红书封面请使用 `rednote-cover-maker`；竖版短
视频封面请使用 `douyin-cover-maker`。它们都没有安装时，请说明这件事超出本 Skill 的范围，
而不是在这里把封面做了。

标题里的说法、人名、数字、资质和频道信息都只能来自用户。用户给的关键帧能指导画面里看得见
的内容，但它不是用户没有说过的事实的依据。

## 输入与默认值

复用对话中已有的选题、拟定标题、脚本或大纲、受众、频道风格、素材图、必须保留的主体和目标
画布。选题或拟定标题是硬输入：缩略图必须能和标题一起读，两者都缺时先问再付费。

用户手上只有视频时，请他导出一帧或截图。关键帧需要作为文件提供，不能从视频里取。

默认先用文字给出三个缩略图方向、一条推荐、标题匹配建议、稳妥的文字层级，以及一条频道一致性
规则。三个方向必须是结构差——不同主体、裁切或好奇心缺口——不是同一布局的三套换色。至少一
版落在用户已点名的同赛道参考上。出图才花钱，所以先把方向说清楚，只把用户选中的那一个做出来。
把和标题互补的好奇心缺口写进付费确认卡。

- 用户提供了关键帧、人物照或商品图时走 `beatra.images.transform`，并把那张图放在 `images[0]`。
- 没有素材图的纯概念走 `beatra.images.generate`。
- 对已接受的缩略图做局部修改走 `beatra.images.edit`。
- 除非用户另有要求，使用 `2K`、`16:9` 画布、`model: "auto"` 和 `count: 1`。
- 用户提供的人脸、商品、Logo 和标题里的事实性说法都按必须保留处理。

## 技能工作流

1. 先写简报：标题、这条视频承诺了什么、受众、主体、素材图、频道风格、目标画布、必须保留
   的元素，以及要避免的字眼。
### 步骤2：描述三个候选方向
   用文字描述三个明显不同的方向——主体、对比、文字区、与标题的关系、背景处理——并推荐一个。
### 步骤3：付费前确认
   针对选定能力读取实时卡片，然后展示一次确认：原图与参考图顺序、完整提示词、必须保留的元素、解析后的画布、模型行为、控制项、`count`、当前最高费用和总调用次数。
### 步骤4：提交任务
   获批之后，生成一个稳定且不透明的 `client_request_id`，通过随包客户端只提交一次，并保存返回的任务 ID。
### 步骤5：轮询与交付
   轮询原任务，对照简报复核可访问的结果，交付图片及其真实信息、标题匹配建议，以及一条可复用的频道规则。

简报、确切载荷、画布处理、确认、任务找回与成图复核见[缩略图工作流](references/workflow.md)。

## 付费前确认

规划、比较方向和起草提示词都免费。出图或修改之前，要就冻结后的简报、付费图片请求、原图与
参考图顺序、画布、模型、控制项、`count`、当前价格、最高费用和总调用次数，取得一次明确确认。

用户要求把文字排进画面时，在这次确认里冻结确切文案和它的位置，并在同一次确认里说明模型不一定
能把这些字一模一样地画出来，画错了属于新的一次付费调用，而不是能直接修好的问题。同时给出另
一条路：留出干净的标题安全区，之后在图片编辑软件里自己排标题。无论走哪条，都把标题单独保留，
让用户看到成图后仍可改。

更换原图、参考图顺序、提示词、画布、模型、张数、控制项或画面文字，都属于新的付费工作，需要
新的确认和新的 `client_request_id`。

## 执行与交付

远程操作只使用本 Skill 随包的 `scripts/mcp_client.py`。在 `call <tool-name>` 之后通过标准输入传入一个
JSON 对象。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为回退。命令与连接
排查见[随包 MCP Client 连接诊断](references/mcp-connection.md)。

随包客户端会在首次使用时自己通过 `beatra.installations.register` 完成注册，没有需要手动调用
的注册子命令。返回的 `task_id` 属于这次已获批的工作：只用 `beatra.tasks.get` 轮询。只有创建
请求的响应确实未知时，才用逐字节一致的冻结载荷和同一个 ID 重放一次；终态 `failed` 是已知
结果，需要重新确认而不是重放。任务 ID 丢失时，用 `beatra.tasks.list` 按原能力查找，并沿着
每一个 `next_cursor` 翻完覆盖提交时段的页，再用 `beatra.tasks.get` 确认候选。只有用户要求时
才调用 `beatra.tasks.cancel`；遇到 `409` 时继续轮询原任务，只有终态为 `status: "canceled"`
时才报告已取消。

只对可访问的图片复核，并说明宿主无法完成哪些检查。只交付任务完成后的真实信息：artifact 链接、返回
尺寸、格式、解析后的模型、任务 ID 和 `billing.net_charged_credits`。描述这张缩略图做了什么，
而不是预测它会带来什么效果。

## 按任务查阅参考

- [缩略图工作流](references/workflow.md)：简报、载荷、画布、确认、找回与复核。
- [安装与认证](references/installation-and-auth.md)和
  [安装注册](references/installation-registration.md)：首次使用与凭据。
- [任务与结果](references/tasks-and-results.md)和
  [计费、错误与恢复](references/billing-errors-and-recovery.md)：返回的任务字段、余额、校验与
  结构化错误。
- [随包 MCP Client 连接诊断](references/mcp-connection.md)和

使用说明

# YouTube 缩略图制作

一句话：把选题、标题或关键帧做成主体明确、层级清楚并为标题留位的 YouTube 缩略图。

## 使用

直接对话，例如：

- 「给这条视频做一张缩略图：标题是XX，这是关键帧截图」
- 「基于这期封面，给我三条不同构图的候选方向」

## 工作原理

技能先免费产出三个结构性差异的候选方向并推荐一个，付费前展示冻结简报与费用确认卡；确认后调用 AI 生图接口提交任务并轮询交付，同时给出标题匹配建议与频道视觉一致性规则。人脸、商品、Logo 等素材按必须保留处理。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。