Agent Skill

图生视频与照片动画

把一张产品图、人像、插画、海报或 AI 图片转成有明确动作与运镜的短视频。这项图生视频和照片转视频工作流会先确认主体动作、镜头运动、节奏、时长与画幅,把产品外形、人物特征、Logo 和构图作为重点保留,再生成并复核成片。适合让照片动起来、图片动画、产品图转视频、人物照片动起来、社交短视频开场、电影感运镜和插画动态化。

设计多媒体·beatra·来自 skill_hub·skillhub.cn ↗
skillhub install @beatra-ai/image-to-motion
5 Stars·5.9万 综合热度·3,766 字文档·源站更新 2026-11-22

README 文档

3,766 字

图片转动态视频

将用户提供的一张静态图片转成一条目标明确的图生视频短片。当所需结果必须从这张准确的 产品图、人像、照片、插画、海报或 AI 图片出发,并加入经过设计的主体动作、镜头运动和 节奏时,使用本 Skill。

范围与相邻路线

触发条件是把一张已提供的静态图片变成一条短片。纯文本请求交给文生视频;严格指定首尾帧 的请求交给首尾帧生视频工作流;修改或延长现有视频交给视频编辑或延长工作流;说话、口型 同步或音频驱动的讲述者交给数字人口播工作流。将可行的动态或视频编辑请求保留在合适的 视频路线上,绝不要用图片生成替代。

输入与默认值

唯一硬性输入是一张宿主 Agent 可以查看的可访问图片。如果图片缺失或无法访问,只询问这张 图片,并在诊断或付费准备前停止。复用已知的投放目的、动作意图、必须保留项和构图,不要 重复询问。如果宿主 Agent 可以查看本地文件,就通过随包辅助工具上传以便传输:

python3 scripts/mcp_client.py upload ./selected-image.png --mime-type image/png

上传只是传输,不是诊断。上传前查看可见源图,保留返回的产物引用,绝不要把本地路径传给 远程工具。

默认制作一条短片,使用 model: "auto",并把用户提供的图片作为严格首帧。读取实时 imagetovideo 信息卡后,写入该卡允许的最短整数 duration。除非投放目的或用户明确 选择有此要求,否则省略画幅、分辨率、音频和所有其他可选控制项;必须发送分辨率时,使用 卡允许的最低档,除非用户点名更高档。围绕一个清楚可辨的主体动作和一个主要运镜构建方向。 将用户要求的人脸、产品外形、Logo、文字和构图作为必须保留项;不要预先要求用户降低这些 优先级。生成式运动无法保证后续帧逐像素一致,因此交付后要复核成片是否发生偏移。

标准路径

  1. 查看可见图片。识别主体、构图、受保护细节、投放目的、一个主体动作、一个运镜和节奏,

并将其写成一份紧凑的动态方案。不要用 beatra.images.generate 或 beatra.videos.enhance_prompt 替换用户提供的静帧。

  1. 在报出兼容性、时长、分辨率或数值估价之前,调用 beatra.models.list 并传入

{"capability":"imagetovideo"}。除非用户选定了一个当前可用的具体模型,否则保持 model: "auto"。用一张当前信息卡完整准入整份载荷。写入该卡允许的最短整数 duration。除非用户选择或投放目的另有要求,否则省略画幅和其他可选控制项。任何数值 费用估算都只是暂定值;绝不要引用记忆中的价格。终态任务的 billing.netchargedcredits 才是最终费用。

  1. 在创建任何 clientrequestid 或调用 beatra.videos.animate 之前出示入场卡:路线

imagetovideo、工具 beatra.videos.animate、源图、动态方案、时长、若已设置的分辨率、 输出数量、实时暂估价、注册赠额 600 分通常买不起这一单视频,以及余额不足时怎么办。 规划、比较或「去做这条短片」不构成批准。在用户确认已充值或余额足够覆盖本次估价之前, 不要提交。

  1. 在私有执行台账中固定图片引用、使用时的提示词、模型、时长、画幅、分辨率、音频、每项

可选控制,以及一个不透明且稳定的 clientrequestid。只能调用随包 scripts/mcp_client.py:MCP 工具名作为 CLI 参数,工具参数通过标准输入以 JSON 传入。 例如:

   printf '%s' '{"image":{"type":"artifact","artifact_id":"art_opening"},"prompt":"A restrained camera push while the product remains centered.","duration":5,"client_request_id":"opaque-stable-id"}' | python3 scripts/mcp_client.py call beatra.videos.animate

不要配置、调用或使用宿主 Beatra Connector。不得使用 REST/OpenAPI 作为降级或回退方案。 beatra.videos.animate 只提交一次。

  1. 立即记录返回的任务 ID,并使用 beatra.tasks.get 轮询同一任务直至终态。排队中和运行中

都是进度状态,绝不能成为重新提交的理由。

  1. 交付返回的每个视频产物或链接。只报告真实返回的事实:任务 ID 和状态、解析后的模型、

尺寸、时长、用量和 billing.netchargedcredits。将成片与源图对照,检查主体稳定性、 预期和意外动作、镜头连贯性、节奏、必须保留项偏移及投放适配度。说明宿主 Agent 实际 可以检查与无法检查的范围;绝不要声称查看了无法访问的画面或音频。

付费修改、恢复与取消

源图、提示词、模型、时长、画幅、分辨率、音频或其他控制项发生变化,都属于新的逻辑付费 任务:创建新 ID,展示变更后的入场卡,并重新取得充值或余额确认。绝不要为参数不同的请求 复用 ID。遇到 insufficient_balance 时,转述返回文案,充值 URL 保持原样,只有用户说已 充值后才用同一冻结 ID 重试。

创建响应丢失时,只有参数完全相同且 ID 相同时才允许重试。如果任务 ID 丢失,调用 beatra.tasks.list 并传入 {"capability":"imagetovideo"},为可能的候选调用 beatra.tasks.get,并将它们返回的事实与私有台账匹配,再考虑执行完全相同的重试。在规划 变更后的任务前,先恢复原任务。失败和超时不会授权重复提交或猜测退款。

只有用户要求取消时才调用 beatra.tasks.cancel。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)。

同分类其他技能

查看全部 ›