前言¶
做角色動效時，常見路徑是：在即夢或同類工具裏手動上傳素材、寫提示詞、等生成，再把結果拖回工程。若你已經在 Cursor、Claude Code 等環境裏用 Agent 寫腳本、批處理素材，更希望用一句話讓模型按固定參數調用「圖生動作視頻」，而不是每次重複同一套網頁操作。
下面介紹 SkillHub 上的 jimeng dream actor（座標 @user_f95f21b8/dlazy-jimeng-dream-actor，當前版本 1.0.9）。它把即夢 Dream Actor 能力封裝成通用 SKILL.md，由 Agent 通過 dLazy CLI 調用雲端 API，把靜態人物圖片轉爲動作視頻。
這是什麼¶
jimeng dream actor 的定位是：在 Agent 側提供「靜態人物圖 → 生動動作視頻」的調用規範。SkillHub 分類爲 design-media，來源爲 community，發佈者爲 user_f95f21b8；底層推理與媒體託管由 dLazy（維護者 dlazyai，CLI 見 github.com/dlazyai/cli）提供，技能本身是 dLazy 託管 API 的輕量封裝。
官方簡介（英文）：Convert static character images into vivid action videos with Jimeng Dream Actor.
中文 SKILL 表述爲：使用即夢 (Jimeng) Dream Actor，將靜態人物圖片轉化爲生動的動作視頻。
SkillHub 頁面標註 requires_api_key=true：使用前必須配置 dLazy API Key，並按賬戶積分計費。
核心功能¶
結合已發佈的 SKILL.md / SKILL-cn.md，可覈實的能力如下。
- 圖生動作視頻：以人物靜態圖爲主輸入，配合
--prompt描述動作或場景，調用模型jimeng-dream-actor-m1-gen-video-cv。 - 可選參考視頻：
--videos支持 1 個參考視頻（本地路徑或 URL），與參考圖組合使用（--images最多 1 張）。 - Agent 可編排的 CLI 參數：
--dry-run（僅估算 payload 與費用）、--no-wait（異步返回generateId）、--timeout（默認等待 1800 秒）；支持與 dLazy 管道引用（見dlazy --help）。 - 觸發關鍵詞（便於自然語言喚起）：如
jimeng dream actor、image to video、make image move、action video；中文側含「即夢 dream actor」「圖片生成視頻」「讓圖片動起來」等。
調用時，提示詞與參數發往 api.dlazy.com；本地圖像/視頻路徑由 CLI 上傳至 files.dlazy.com；結果 URL 同樣託管在該域名。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方說明執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向本機 Agent 識別的 skills 路徑，否則默認落在 ./skills/ 可能不會被加載。常見路徑：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（Cursor）：
skillhub install @user_f95f21b8/dlazy-jimeng-dream-actor --dir ~/.cursor/skills/
也可在對話中讓 Agent 按 SkillHub 安裝說明 安裝同一座標。
裝好後重啓或刷新 Agent，使新 Skill 生效。
3. 安裝並配置 dLazy CLI¶
技能元數據要求本機具備 npm / npx，並固定使用 @dlazy/cli@1.0.9：
npm install -g @dlazy/cli@1.0.9
或按需單次調用：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（寫入 ~/.dlazy/config.json，亦可用環境變量 DLAZY_API_KEY）：
dlazy auth set YOUR_API_KEY
Key 在 dlazy.com/dashboard/organization/api-key 獲取。
典型用法¶
Agent 側的核心指令是執行 dlazy jimeng-dream-actor。先查看幫助：
dlazy jimeng-dream-actor -h
幫助中列出的主要選項包括 --prompt、--images（最多 1 張）、--videos（最多 1 個），以及 --dry-run、--no-wait、--timeout 等。
官方示例（本地圖）：
dlazy jimeng-dream-actor --prompt 'prompt text' --image '/path/to/image.png'
遠程圖 URL 示例：
dlazy jimeng-dream-actor --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'
說明：-h 輸出使用 --images / --videos，部分示例使用 --image；若命令報錯，以當前 CLI 幫助爲準，或對照 dlazy jimeng-dream-actor -h 的實際 flag 名稱。
成功時 CLI 返回 JSON，result.tool 爲 jimeng-dream-actor，outputs 中含生成資源的 url。若使用 --no-wait，需用 dlazy status <generateId> --wait 輪詢。
在 Agent 對話中，可直接描述需求並帶上觸發詞，例如：「用 jimeng dream actor，根據這張人物立繪生成走路動作，提示詞寫……」——模型應讀取 Skill 後組裝上述命令。
適用場景與注意¶
適合誰
- 已在 Agent 工作流裏處理分鏡、角色卡、短視頻素材，需要 repeatable 的「人物靜圖 → 動作片段」步驟。
- 願意使用 dLazy 賬戶與 API，接受素材上傳雲端生成。
限制與注意
- 必須有餘額與有效 Key：
unauthorized、insufficient_balance等錯誤需按 SKILL 指引處理 Key 或充值（credits 設置頁）。 - 隱私與合規：本地路徑文件會上傳至 dLazy 媒體存儲；涉密素材勿直接傳入。
- 輸入上限：參考圖、參考視頻各最多 1 個；
--prompt爲必填（缺失會報 501 類錯誤）。 - 社區 Skill：SkillHub 評分爲 100000，截至資料抓取時下載 1039、安裝 2；行爲以包內
SKILL.md與 CLI 版本 1.0.9 爲準，升級前留意 changelog。
結尾¶
jimeng dream actor 把即夢 Dream Actor 的圖生動作視頻能力收斂成 Agent 可執行的 Skill：SkillHub 負責分發與版本，dLazy CLI 負責鑑權與 API 調用。若你的痛點是「在 IDE 裏用自然語言批量做人物動效」，可先安裝 Skill、配置 Key，再用 dlazy jimeng-dream-actor 驗證一條最小命令。
官方入口：
- API 座標頁：https://api.skillhub.cn/user_f95f21b8/dlazy-jimeng-dream-actor
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-jimeng-dream-actor
