前言¶
產品圖、人像或海報要變成幾秒可用的動態素材時，常見做法是單獨開圖生視頻工具、手寫運鏡提示詞，再反覆試參數。主體變形、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。
