shield_lock
JinDaGe
← Back to skills
extension
Category: Marketing & GrowthNo API key required

YouTube视频缩略图制作

把 YouTube 选题、标题、脚本、关键帧、人物照、商品图或频道参考，制作成焦点明确、标题匹配并适合长视频浏览的缩略图候选。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

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）和 卸载与断开连接（references/uninstall-and-disconnect.md）：客户端操作与移除。

运行时与安全自动更新

随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地 自动安装。它只使用固定的 Beatra 官方发现地址与不可变 CDN 路径，在替换之前校验发现信息、 压缩包、清单和每个随包文件，并且只替换本包拥有的文件。

检查、下载、校验、替换和恢复失败时都不会中断：当前安装仍可使用，原本请求的命令会继续执行。 更新失败绝不构成执行付费工作的理由。这个设置会在本安装中持续生效。官方来源、完整性校验、 替换边界、失败行为与开关详见自动更新与安全（references/automatic-updates-and-safety.md）。

python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check