Agent Skill

AI首尾帧视频生成

用两张审核好的图片——一个首帧和一个尾帧——生成一条从首帧到尾帧的短转场视频。这个 AI 首尾帧视频生成和两张图生成视频工作流可以制作变装转场、产品揭晓、前后对比、昼夜切换、场景瞬移,并在两帧之间规划运镜、主体路径和揭晓节奏,交付后先确认视频确实从首帧开始、在尾帧结束,再检查中间运动、方向、时长和声音。适合变装转场、产品揭晓、前后对比、场景转换和电影感收尾,每次只做一条转场并如实复盘。

设计多媒体·AI音乐人·来自 skill_hub·skillhub.cn ↗
skillhub install @user_87b8e34f/first-last-frame-video
7 Stars·13.7万 综合热度·4,342 字文档·源站更新 2026-11-22

README 文档

4,342 字

AI首尾帧视频生成

从一个确认的首帧到一个确认的尾帧,生成一条短的有方向的运动路径。本 Skill 适用于用户有两张端点图片,并要求首尾帧短片、双图转场、前后变身、变装转场、产品揭晓、昼夜切换、场景瞬移或循环式视觉回归。

适用范围与相邻路由

常规路线是两张确认图片和它们之间的一条转场片段。需要让单张起始图片动起来的请求路由到图生视频工作流;需要在一条源视频前后补画面的请求路由到视频续写工作流;需要转绘已有片段的请求路由到视频转绘工作流。本路线专注于两个严格图片端点之间的有方向转场。

输入与默认值

硬性输入是:

  • 两张具有清晰特征的确认端点图片(一个首帧和一个尾帧),宿主 Agent 可以查看;
  • 两帧之间应发生的事件。

只询问缺失的硬性输入。复用已知的场景、氛围、画幅和声音偏好。如果某个端点尚不存在,必须在生成视频之前作为单独的图片阶段创建并确认。

对于宿主 Agent 可访问的本地端点图片,仅在查看之后使用随包上传助手:

python3 scripts/mcp_client.py upload ./first-frame.png --mime-type image/png
python3 scripts/mcp_client.py upload ./last-frame.png --mime-type image/png

上传只是传输,不是创意审阅。保留返回的素材引用,绝不向远程工具传递本地路径。

默认输出一条转场片段和 model: "auto"。读完实时 framestovideo 卡片后,写入该卡准入的最短整数 duration。除非投放目的或用户明确选择需要,否则省略分辨率和其他可选控制项;确需设置分辨率时,除非用户点名了更高档位,否则用卡片准入的最低档。查看两端图片的人物特征、几何结构、构图、画幅、背景、光影以及视觉差异。将它们转化为转场映射:固定元素、变化元素、运动方向、镜头以及尾帧上的预定落点时刻。

黄金路径

  1. 查看两张端点图片。记录每张图片的实际 MIME 类型、宽度、高度、画幅和字节大小。识别人物特征、几何结构、构图、背景、光影、两帧之间的视觉差异以及所要求的两帧之间事件。
  2. 从两个端点构建转场映射:固定元素、变化元素、运动方向、镜头以及尾帧上的预定落点时刻。然后写出一条正向转场指令,命名运动应交付的单一事件。
  3. 如果某个端点需要创建,先通过 beatra.images.generate 作为单独的图片阶段制作并确认。读取图片卡的实时 pricing.options,用已准入画布匹配其维度;如果准入前无法确定唯一价格,就以符合条件的最高价格作为批准上限。绝不要按输入图片数量倍增图片估价。依赖尚未创建帧的转场在该帧存在且其真实 MIME 类型、字节和尺寸已通过下游验证之前无法提交。
  4. 在点名兼容性、时长、分辨率或数字估价之前,调用 beatra.models.list 并传入 {"capability":"framestovideo"}。用一张当前卡片准入完整载荷:两张端点图片的实际 MIME 类型、尺寸和字节大小、实时时长行为、画幅处理方式、该图片/音频组合是否允许驱动音频,以及计价基础。写入该卡准入的最短整数 duration。除非用户已选定一个具体的可用模型,否则保持模型为 auto。任何数字估价都是暂定的;终态任务的 billing.netchargedcredits 才是最终扣费。
  5. 在任何 clientrequestid 或 beatra.videos.interpolate 调用之前出示准入卡:路线 framestovideo、工具 beatra.videos.interpolate、首帧和尾帧、转场指令、时长、如有则写分辨率、输出数量、临时实时估价、600 积分注册赠额通常开不了这段视频、以及余额不足时会怎样。规划、比较或「去做这段」都不是批准。用户确认已充值或已有足够积分覆盖本次估价之前,不要提交。单独创建的端点图片是自己的付费图片阶段,并不授权插值调用。
  6. 冻结首帧、尾帧、转场指令、使用驱动音频时的可选驱动音频、模型、时长,以及一个不透明且稳定的 clientrequestid;然后恰好调用一次 beatra.videos.interpolate,使用严格的 firstframe 和 lastframe。只调用随包 scripts/mcp_client.py:MCP 工具名是 CLI 参数,其参数是标准输入上的 JSON。把 5 换成当前卡片实际准入的最短整数:
   printf '%s' '{"first_frame":{"type":"artifact","artifact_id":"art_first"},"last_frame":{"type":"artifact","artifact_id":"art_last"},"prompt":"Transform the subject from the daytime outfit to the evening outfit with a smooth camera push-in, keeping the face and background aligned.","duration":5,"client_request_id":"opaque-interpolate-id"}' | python3 scripts/mcp_client.py call beatra.videos.interpolate

不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 回退。恰好提交一次 beatra.videos.interpolate。

  1. 立即记录返回的任务 ID,并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的视频素材或链接。只报告实际返回的任务状态、解析后的模型、尺寸、时长、用量和 billing.netchargedcredits。审阅可访问的结果以确认确实从已批准的首帧开始、在已批准的尾帧结束,然后检查中间运动、人物和文字偏移、方向、时长和声音。说明宿主 Agent 能和不能查看的内容。

付费变更、恢复与取消

转场是一个付费视频阶段。更换首帧、尾帧、转场指令、驱动音频、模型、时长或控制,都属于新的逻辑付费工作,配以新的 ID、新的准入卡,以及新的充值或余额确认。单独创建的端点图片是其自身的付费图片阶段,拥有自己的请求 ID。遇到 insufficientbalance 时,转达返回的说明,余额错误里的充值链接保持原样,用户说已充值后再用同一冻结的 clientrequest_id 重试。

如果创建响应丢失,只用相同的阶段 ID 重放字节完全一致的冻结负载。如果任务 ID 丢失,调用 beatra.tasks.list 查找相关能力,用 beatra.tasks.get 检查可能的候选任务,并对照该阶段的私有账本确认后再考虑相同重试。排队和运行中是进度状态,不是失败。在规划变更工作之前先恢复原阶段;绝不重复付费提交,也不猜测其扣费或退款。

只有当用户要求取消时才调用 beatra.tasks.cancel。调用一次,并用 beatra.tasks.get 确认最终的终态。409 表示取消未确认,因此继续轮询同一任务,不要创建替代工作。

工具返回积分不足时:把工具返回的原文整段交给用户,链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。

账户余额

用户问还剩多少积分,或某次实时估价够不够时,调用 beatra.wallet.get。问已经扣了多少 时,调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把 wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时,按卡片给出的档位和顺序原样转述。不要给档位排高低,不要 贬低其中任何一档,也不要替用户挑。选哪一档是用户自己的事,钱包页会把整份清单摆在他 面前。任何时候都不要凭记忆报档位。

按任务查阅参考

  • 在构建转场映射、创建端点图片、核对实时模型事实、构造确切负载、轮询、恢复、取消或审阅端点保真度和中间运动时,阅读 首尾帧工作流(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)。不要配置宿主 Connector。
  • 更新与安全:更新与安全(references/updates-and-security.md)
  • 仅当用户要求移除本包或共享凭据时,阅读 卸载与断开连接(references/uninstall-and-disconnect.md)。

每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息 (中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn)。有新版本时,它下载官方发布包, 逐个文件校验 SHA-256,再替换本 Skill 自己的文件;你放进这个目录的其他文件不会被 改动。替换过程中断时,下次运行会自动恢复到替换前的状态。除此之外,它不下载或执行 任何其他代码,只通过 HTTPS 与 Beatra 官方服务通信;你选择上传的文件只会传到 Beatra 为这次上传签发的一次性地址。

关闭自动更新:python3 scripts/mcp_client.py update --auto off。关闭后,客户端每天 最多提示一次在你安装它的商店里更新的命令。详见更新与安全(references/updates-and-security.md)。

同分类其他技能

查看全部 ›