前言¶
在 Agent 裏做「文生視頻」或「圖生視頻」,常見做法是手寫某一條 dlazy 子命令,或事先在文檔裏固定模型名。提示詞一變——要電影感、要敘事、要圖生視頻、要數字人——就得換子命令、查參數表,Agent 也容易選錯模型。
下面介紹的 video generate(座標 @user_f95f21b8/dlazy-video-generate)把選型交給 Skill:根據用戶提示詞在 dlazy CLI 的多條視頻模型裏選最合適的一條,再按該模型的 -h 輸出拼裝並執行命令。底層仍走 dLazy 託管 API,需要 API Key 與賬戶積分。
這是什麼¶
video generate 是 SkillHub 上由社區發佈者 user_f95f21b8 維護的 Agent Skill,當前版本 1.0.9,分類爲 design-media,來源標註爲 community。官方簡介爲:Video generation skill. Automatically selects the best dlazy CLI video model based on the prompt.(中文版 SKILL 表述爲:根據提示詞自動選擇最佳的 dlazy CLI 視頻生成模型。)
Skill 本身是 dLazy API 的薄封裝:維護方在元數據中指向 dlazyai 的 @dlazy/cli(固定 1.0.9),推理請求發往 api.dlazy.com,本地媒體上傳至 files.dlazy.com。SkillHub 標籤 requires_api_key=true,使用前必須配置 dLazy API Key。
核心功能¶
經 SKILL.md / SKILL-cn.md 覈實,該 Skill 提供以下能力:
- 按提示詞自動選型:覆蓋文生視頻、敘事片段、圖生視頻、數字人、動作遷移等場景,在多條
dlazy <model>子命令之間選擇(見下文模型列表)。 - 統一認證與配置:通過
dlazy auth set寫入~/.dlazy/config.json(Windows 爲%USERPROFILE%\.dlazy\config.json),或使用環境變量DLAZY_API_KEY。 - Agent 執行流程固化:先選模型 →
dlazy <model_name> -h查參數 → 執行生成命令;並對 401 未授權、503 餘額不足等錯誤給出明確處置指引。 - 觸發詞:英文含
generate video、text to video、animate image;中文含「生成視頻」「文本轉視頻」「圖片動起來」。
可用的視頻模型(節選自官方 SKILL)¶
| 子命令方向 | 代表模型 | 官方說明 |
|---|---|---|
| 電影感 | veo-3.1、veo-3.1-fast |
高質量電影級片段 |
| 敘事 | sora-2、sora-2-pro |
敘事片段 |
| 通用短視頻 | kling-v3、kling-v3-omni |
通用短視頻 |
| 轉場敘事 | seedance-1.5-pro |
帶轉場的敘事短片 |
| 快速生產 | wan2.6-r2v、wan2.6-r2v-flash |
通用/快速視頻製作 |
| 圖生視頻等 | viduq2-i2v、jimeng-i2v-first 等 |
圖生視頻、數字人、動作遷移 |
CLI 與 npm 包源碼見 github.com/dlazyai/cli,官網爲 dlazy.com。
安裝與啓用¶
安裝分兩層:SkillHub 上的 Skill 包,以及 Skill 依賴的 dlazy CLI。
1. 安裝 SkillHub CLI(若尚未安裝)¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方文檔執行(完整安裝示例):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
說明見 skillhub.cn/install/skillhub.md。
2. 將 video generate 裝進當前 Agent 的 skills 目錄¶
SkillHub 要求 --dir 指向當前客戶端識別的 skills 目錄,否則默認落在 ./skills/ 可能不會被加載。以 Cursor 爲例:
skillhub install dlazy-video-generate --namespace user_f95f21b8 --dir ~/.cursor/skills/
SkillHub 頁面給出的安裝提示爲:根據上述安裝文檔,安裝 @user_f95f21b8/dlazy-video-generate。其他客戶端常見路徑(同樣來自官方安裝文檔)包括 Claude Code 的 ~/.claude/skills/、Codex 的 ~/.codex/skills/ 等;按你實際使用的 Agent 替換 --dir 即可。
3. 安裝 dlazy CLI¶
Skill 元數據要求本機具備 npm / npx,並固定 CLI 版本 1.0.9:
npm install -g @dlazy/cli@1.0.9
也可按需調用、不全局安裝:
npx @dlazy/cli@1.0.9 <command>
4. 配置 API Key¶
在 dlazy.com/dashboard/organization/api-key 獲取密鑰後寫入 CLI:
dlazy auth set YOUR_API_KEY
經上述步驟後,重啓或刷新 Agent 的 Skill 加載,即可在對話中用觸發詞喚起該 Skill。
典型用法¶
官方未提供固定「一條命令出片」的示例參數,而是規定 Agent 的三步流程。下面按 SKILL 可復現的方式說明。
第一步:用自然語言描述需求(會命中 Skill 觸發詞),例如「根據這段文案生成 16:9 敘事短視頻」或「讓這張產品圖動起來」。
第二步:Agent 選定模型後查看幫助(模型名以空格形式作爲 dlazy 子命令,具體以 -h 爲準):
dlazy kling-v3 -h
第三步:按幫助中的必填項執行(多數模型需要 --prompt;圖生視頻類還需傳入圖片路徑或 URL,本地路徑會上傳到 files.dlazy.com):
dlazy kling-v3 --prompt "清晨城市天際線,鏡頭緩慢推進"
若需先估算費用而不調用 API,可查對應模型是否支持 --dry-run(以該模型 -h 輸出爲準)。異步任務場景下,部分模型支持 --no-wait 等選項,同樣以 -h 爲準。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skill 的客戶端,希望用一句話完成「選型 + 調參 + 調 API」,而不是維護多張模型對照表。
- 團隊統一走 dLazy 賬戶與
@dlazy/cli@1.0.9,需要 Agent 在餘額不足、Key 失效時給出官方充值與 Key 頁面鏈接。
限制與注意
- 必須聯網,且消耗 dLazy 積分;
insufficient_balance時需到 積分設置頁 充值。 - 本地文件會上傳到 dLazy 媒體存儲,敏感素材需自行評估合規性。
- Skill 只負責選型與調用規範,具體分辨率、畫幅、時長等以各模型
-h爲準,升級 CLI 版本前應對照 Skill 元數據中的固定版本 1.0.9。 - SkillHub 統計(抓取於編寫時):評分 100000,下載 1297 次;頁面數據會變動,以 SkillHub 爲準。
結尾¶
video generate 把「多條 dlazy 視頻模型如何選、怎麼查參、出錯怎麼辦」寫進 SKILL,讓 Agent 按提示詞自動走到正確的 dlazy 子命令,而不是每次從零查文檔。若你要在 Agent 工作流裏接 dLazy 視頻能力,可從 SkillHub 安裝該 Skill,並備好 API Key 與 CLI。