前言¶
在 Cursor、Claude Code 等環境裏做短視頻，常見做法是單獨打開控制台、手工上傳參考圖、再等任務完成。模型參數、畫幅和時長往往要對照文檔逐項填寫，Agent 很難在一次對話裏把「提示詞 + 參考素材 + 生成命令」串成可復現流程。
下面介紹的 kling v3 omni（SkillHub 座標 @user_f95f21b8/dlazy-kling-v3-omni，當前版本 1.0.9）把可靈 Kling v3 Omni 能力封裝成標準 Skill：Agent 按 SKILL.md 調用 dLazy CLI 的 dlazy kling-v3-omni，由雲端 API 完成推理並返回結果 URL。Skill 歸類爲 design-media，來源爲社區發佈（發佈者 user_f95f21b8），頁面標註 requires_api_key=true，使用前需配置 dLazy API Key。
這是什麼¶
一句話定位：基於 dLazy 託管 API 的輕量 Skill，用於調用 Kling v3 Omni 做通用動態視頻生成，支持多模態輸入（提示詞、圖片 URL 或本地路徑等，具體以 CLI 參數爲準）。
維護與實現關係如下：
- Skill 由社區用戶
user_f95f21b8發佈在 SkillHub，底層 CLI 由 dlazyai 維護，npm 包爲@dlazy/cli@1.0.9，源碼見 github.com/dlazyai/cli。 - 推理請求發往
api.dlazy.com，本地媒體文件由 CLI 上傳至files.dlazy.com；生成結果 URL 同樣託管在該域名。
官方 Skill 頁與 API 入口：
- 展示頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-kling-v3-omni
- API 地址：https://api.skillhub.cn/user_f95f21b8/dlazy-kling-v3-omni
（截至資料抓取時，SkillHub 側評分約 100000，下載 1154 次，安裝記錄 2 次；數值會隨站點更新變化。）
核心功能¶
以下能力均來自 Skill 包內 SKILL.md / SKILL-cn.md 與 CLI 幫助說明，不展開未在文檔中出現的模型細節。
-
多模態視頻生成
英文簡介：Versatile video generation with Kling v3 Omni. Supports multi-modal inputs to generate stunning dynamic videos.
中文說明強調文生視頻、圖生視頻等場景，觸發詞包括kling v3 omni、generate omni video、text to video, image to video等。 -
生成模式與參考素材
-generation_mode：frames（默認）或components。
-frames模式下可用--images傳入最多 7 張參考圖（URL 或本地路徑）。
-components模式下還可配置subjects（最多 3）、videos（最多 1）及視頻參考類型video_refer_type（feature/base）等，部分參數僅在對應模式下生效。 -
畫面與質量參數
- 畫幅aspect_ratio：16:9、9:16、1:1（在特定視頻參考組合下可能不可用，以 CLI 條件爲準）。
- 時長duration：3–15 秒，默認 5 秒。
- 模式mode：std或pro；可選sound音效、--dry-run預估費用而不真正調用 API。 -
同步與異步
默認等待任務完成；加--no-wait可立即拿到generateId，再用dlazy status <generateId> --wait輪詢。--timeout默認最長等待 1800 秒。 -
管道式編排
各參數支持 dLazy CLI 的 pipe 引用（如-、@N、@stdin等），便於在多步 Agent 工作流裏串聯上一步輸出。
安裝與啓用¶
安裝分兩層：先把 Skill 裝進當前 Agent 的 skills 目錄，再確保本機可執行 dlazy 並完成鑑權。
1. 安裝 SkillHub CLI（如尚未安裝）¶
按 SkillHub 安裝說明 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔中的推薦方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 安裝到當前 Agent 目錄¶
SkillHub 要求 --dir 必須指向當前 Agent 識別的 skills 目錄，否則默認落到 ./skills/ 可能不會被加載。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝命令形如：
skillhub install @user_f95f21b8/dlazy-kling-v3-omni --dir ~/.cursor/skills/
也可讓 Agent 按官方提示執行：依據 https://skillhub.cn/install/skillhub.md 安裝 @user_f95f21b8/dlazy-kling-v3-omni。Skill 頁還提供 1.0.9 版本的 Zip 直鏈（api.skillhub.cn/api/v1/download?slug=@user_f95f21b8/dlazy-kling-v3-omni），適合離線解壓到上述目錄。
安裝或更新 Skill 後，按你所用客戶端說明重啓或刷新，以便加載新的 SKILL.md。
3. 安裝 dLazy CLI¶
Skill metadata 固定 CLI 版本 1.0.9，需要本機具備 npm / npx：
npm install -g @dlazy/cli@1.0.9
若不想全局安裝，可按次調用：
npx @dlazy/cli@1.0.9 <command>
4. 配置 API Key¶
在 dlazy.com 註冊後，於 組織 API Key 頁面 創建密鑰，再寫入 CLI：
dlazy auth set YOUR_API_KEY
密鑰保存在 ~/.dlazy/config.json（Windows 爲 %USERPROFILE%\.dlazy\config.json），也可通過環境變量 DLAZY_API_KEY 按次傳入。
典型用法¶
Agent 側的核心指令是：在終端執行 dlazy kling-v3-omni 並解析 JSON 輸出。先查看完整參數：
dlazy kling-v3-omni -h
Skill 文檔中的基礎示例（文 + 本地圖）：
dlazy kling-v3-omni --prompt '提示詞內容' --image '/path/to/image.png'
使用遠程圖片 URL 的示例：
dlazy kling-v3-omni --prompt '提示詞內容' --image 'https://files.dlazy.com/image.png'
說明：CLI 幫助裏參考圖參數名爲 --images（可多張），示例裏使用 --image；若命令報錯，請以 dlazy kling-v3-omni -h 當前版本輸出爲準。
成功時返回結構大致如下（outputs 中 type / mimeType 以實際任務爲準）：
{
"ok": true,
"result": {
"tool": "kling-v3-omni",
"modelId": "kling-v3-omni",
"outputs": [
{
"type": "image",
"id": "o_xxxxxxxx",
"url": "https://files.dlazy.com/result.png",
"mimeType": "image/png"
}
]
}
}
在調用真實 API 前，可用 --dry-run 查看 payload 與費用預估；長任務建議熟悉 --no-wait 與 dlazy status 的組合。
適用場景與注意¶
適合誰
- 已在使用 Cursor / Claude Code 等支持 Skills 的客戶端，希望在對話裏直接發起可靈 Omni 視頻任務的內容、設計或自動化流程開發者。
- 願意使用 dLazy 賬號與 API 計費，並接受素材上傳至
files.dlazy.com的 SaaS 調用模式。
限制與注意
- 依賴與網絡：需要 Node 生態（npm/npx）、可訪問 dLazy API，以及有效的 API Key 與賬戶餘額。
- 錯誤碼：401 多爲 Key 缺失或無效；503 可能出現
insufficient_balance，需至 積分設置頁 充值；本地路徑錯誤會表現爲文件未找到。 - 合規與安全：提示詞與素材需符合平臺安全策略；Skill 本身不額外訪問文件系統，上傳與推理均由官方 CLI 完成。
- 版本：Skill 與 CLI 均釘在 1.0.9，升級前建議在 SkillHub 查看版本歷史並與 npm 包版本對齊。
結尾¶
經過上面的步驟，你可以在 Agent 裏用統一命令把 Kling v3 Omni 的多模態視頻生成接進日常流程：Skill 負責觸發詞與參數約定，dLazy CLI 負責鑑權、上傳與輪詢，結果以 URL 形式回到對話上下文。
Skill 官方入口：https://api.skillhub.cn/user_f95f21b8/dlazy-kling-v3-omni
SkillHub 展示頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-kling-v3-omni
