shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

板书一镜视频·板书照转一镜

按教师提供的板书事实，为每张板书照做成一条板书照转一镜短片。

personAuthor: beatra01hubOpenAPI
open_in_newRepositorydownloadDownload package

板书一镜视频·板书照转一镜

把已授权的板书照和教师提供的板书事实，做成每张照片一条短片。按拍摄顺序交付。不要拼接。

适用范围与相邻路线

教师要用已经拍好的板书照做短片时，使用本 Skill。

一张照片加口播做成讲解成片时转到 wrong-item-talking。组装步骤转到 assembly-one-step-clip。不是标注板书的通用静帧转到 image-to-motion。企业工具照转到 tool-demo-clip。不要到公开帖子里补缺失的板书文字。

输入与默认值

硬输入是：

  • 至少一张宿主 Agent 可以查看的板书照，并按拍摄顺序排好；
  • 教师提供的板书事实，说明每张照片里是哪一课、哪几行板书、哪一步或序号。

不要编造缺失的板书文字、公式、排名或口播句。照片不是未写明文字的来源。复用对话里已有的课题名称、语言、投放位置和必须保留项。只补问缺失的硬输入。

默认每张照片一次 beatra.videos.animate，model: "auto"，照片作严格首帧，不带 driving_audio，画幅由源图决定。和用户选定 2-15s 范围内的整数时长；用户不选时用 5s。

标准路径

  1. 查看每张照片。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传。绝不要把本地路径传给远程工具。

  2. 只用教师事实和照片里看得到的内容写带标注的一照一镜计划。保持拍摄顺序。缺事实的照片留在计划里。这份计划就是免费可见结果。规划不是批准。

  3. 调用 beatra.models.list 并传入 {"capability":"image_to_video"}。对照当前卡片，确认接受无 driving audio 的首帧图。把每张图的事实和选定时长对照公布约束。任何必要媒体事实不可用或不兼容时，停在视频之前。

  4. 任何视频 client_request_id 或 beatra.videos.animate 调用前，先出示一张当前生产卡并等待：

    1. 做什么 — 每张点名的板书照一条短片，一次生成调用（beatra.videos.animate）。
    2. 积分 — 刚读到的 image_to_video 价格。不要复用记忆中的数字。
    3. 几笔 — 每张照片一次付费调用。不要把多张照片塞进同一次提交。
    4. 身份 — 每张照片一个新的不透明 client_request_id。提示词、照片、时长、模型或控件变了就换新标识。
    5. 若停在这里 — 带标注的短片计划仍然可用。
    6. 若余额不足 — 原样转达官方说明和充值链接（https://console.beatra.ai/wallet?intent=buy）。翻译正文，保留链接。教师说已充值之前不要重试。不要推荐 ¥198。

    用户确认已充值或余额足够之前不要提交。

  5. 每张已准入照片只提交一次 beatra.videos.animate，且只通过随包 scripts/mcp_client.py。不要配置宿主 Beatra Connector。也不要使用 REST/OpenAPI 作为降级。每条视频任务用 beatra.tasks.get 轮询到终态。

  6. 按拍摄顺序交付短片，带上实际尺寸、时长、用量和 billing.net_charged_credits。核对板书身份、运动和必须保留的细节漂移。绝不要发明拼接、concat 或剪辑工具。

需要确认的决定

规划和当场报价不扣费。它们不是批准。视频动画需要上面的六字段卡。拿到文件不等于同意把照片用到这套板书之外。

恢复

每张付费照片有自己的冻结载荷和标识。丢失创建响应时，只许用该照片完全相同的载荷恢复。丢失任务标识时，通过 beatra.tasks.list 和 beatra.tasks.get 找回。只有用户要求取消该照片时才调用 beatra.tasks.cancel；遇到 409 继续轮询。遇到 insufficient_balance 时保持充值链接原样，用户说已充值后才用同一冻结标识重试。创建返回没有 task_id 时不要轮询；对账后再决定是否签发新标识。照片、提示词、时长或模型变了就是新工作，要换新卡。

执行

每个远程 Beatra 操作都只通过本包随附的 scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "image_to_video"}

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

按任务查阅的参考

  • 短片计划、载荷、确认、轮询、恢复和审片，读 Blackboard one-shot workflow（references/workflow.md）。
  • 授权和非计费注册步骤，读 installation and authentication（references/installation-and-auth.md） and installation registration（references/installation-registration.md）。
  • 共用的任务、计费和连接细节，读 tasks and results（references/tasks-and-results.md）、billing, errors, and recovery（references/billing-errors-and-recovery.md） 和 随包 MCP Client 连接诊断（references/mcp-connection.md）。
  • 更新保证和控制，读 automatic updates and safety（references/automatic-updates-and-safety.md）。移除时读 uninstall and disconnect（references/uninstall-and-disconnect.md）。

运行时与安全的自动更新

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

更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费视频请求的理由。这个设置会在本安装中持续生效。见 automatic updates and safety（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