前言¶
产品图、人像或海报要变成几秒可用的动态素材时，常见做法是单独开图生视频工具、手写运镜提示词，再反复试参数。主体变形、Logo 糊掉、节奏和画幅对不上平台要求，往往要多轮导出才能用。下面介绍 SkillHub 上的 图生视频与照片动画（@beatra-ai/image-to-motion）：在 Agent 里用结构化工作流，先对齐动作与镜头，再生成并复核成片。
这是什么¶
图生视频与照片动画 是 beatra 发布的企业级 Skill（design-media 分类），坐标 @beatra-ai/image-to-motion，当前版本 0.2.3。官方资源地址：
- Skill 包：
https://api.skillhub.cn/beatra-ai/image-to-motion - SkillHub 页面：
https://www.skillhub.cn/skills/beatra-ai/image-to-motion
它面向「单张图 → 短视频」：把产品图、人像、插画、海报或 AI 图片转成有明确主体动作与镜头运动的短片。页面标注 requires_api_key=false，安装本 Skill 本身不强制配置 API Key（具体生成能力仍取决于 Agent 与后端模型/服务的接入方式）。
核心功能¶
依据官方简介，工作流大致分为「确认参数 → 生成 → 复核」：
- 先确认：主体动作、镜头运动、节奏、时长、画幅（比例）。
- 重点保留：产品外形、人物特征、Logo、构图，避免动态化时主体走形。
- 生成并复核成片：输出可检查的短视频结果。
适用表述包括：让照片动起来、图片动画、产品图转视频、人物照片动起来、社交短视频开场、电影感运镜、插画动态化等。SkillHub 上该 Skill 评分 100000，下载 14133 次（以页面抓取数据为准）。
安装与启用¶
安装说明以 SkillHub 通用文档为准：https://skillhub.cn/install/skillhub.md。要点如下。
1、检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install beatra-ai/image-to-motion --dir <你的 skills 目录>
常用客户端路径（来自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
SkillHub 页面亦提示：可将「请根据 https://skillhub.cn/install/skillhub.md，安装 @beatra-ai/image-to-motion」发给 AI，由 Agent 按文档完成安装。安装或更新后，按你所用客户端要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
公开页面未给出独立 CLI 子命令示例；用法体现在 Skill 工作流 与 对话式交付 上。可按下面步骤在 Agent 中复现官方描述的路径：
- 提供素材：说明源图类型（产品图 / 人像 / 插画 / 海报 / AI 图），并附上图片或路径（以 Agent 支持的方式）。
- 明确动态意图：写清主体动作（例如轻微转头、产品旋转展示）、镜头运动（推近、环绕、平移等）、节奏快慢、目标时长与画幅（如 9:16 竖屏开场）。
- 强调保留项：明确要求保留产品外形、人物特征、Logo、原有构图，减少生成阶段「换脸换形」。
- 生成与复核：让 Agent 按 Skill 流程出片，并对成片做一轮检查（主体是否一致、运镜是否符合预期、时长画幅是否达标）。
经过上面的步骤，你得到的是带明确动作与运镜的短视频，而不是仅做简单 Ken Burns 式平移的静态图动画。
适用场景与注意¶
适合谁
- 需要快速把单张营销图、人像或插画做成社交开场、产品展示短片的设计与运营。
- 希望在对话里统一交代运镜与保留约束，而不是在多个工具间复制提示词的人。
注意
- 版本、下载量、评分以 SkillHub 页面为准；用户线索中的旧数据可能与页面更新不一致，以
https://www.skillhub.cn/skills/beatra-ai/image-to-motion为准。 requires_api_key=false仅表示 Skill 元数据未强制 API Key；实际生成是否调用外部视频模型、是否需要额外密钥，取决于你的 Agent 环境配置。- 复杂多镜头叙事、长片剪辑仍超出「单图动态化」范围，宜拆镜头或配合专业剪辑流程。
结尾¶
图生视频与照片动画 把「动作、运镜、节奏、时长、画幅」和「主体与 Logo 保留」写进同一套 Agent Skill 工作流，适合从一张静态图落到可复核的短视频。安装与优先源说明见 https://skillhub.cn/install/skillhub.md，Skill 详情与安装入口见 https://www.skillhub.cn/skills/beatra-ai/image-to-motion，包地址见 https://api.skillhub.cn/beatra-ai/image-to-motion。
