前言¶
要在對話式 Agent 裏生成短視頻，常見做法是單獨打開可靈或快手的控制台、手寫 HTTP 請求，再把返回的 URL 貼回工作流。參數（畫幅、時長、參考圖路徑）和鑑權容易散落在腳本里，也不利於讓 Cursor、Claude Code 等客戶端統一調用。
下面介紹 SkillHub 上的社區 Skill kling v3（座標 @user_f95f21b8/dlazy-kling-v3）。安裝後，Agent 按技能文檔驅動 dLazy CLI，把提示詞與媒體參數提交到 dLazy 託管的 Kling v3 推理接口，適合把「生成一段視頻」收成可復現的命令步驟。
這是什麼¶
kling v3 是 SkillHub design-media 分類下的社區 Skill（來源：community），當前版本 1.0.9，發佈者爲 user_f95f21b8。SkillHub 簡介爲：基於 Kling v3 的視頻生成，支持高質量的 text-to-video 與 image-to-video。
技能包遵循通用 SKILL.md 格式；包內聲明的技能名爲 dlazy-kling-v3-omni，由 dlazyai 維護的 @dlazy/cli 提供實際調用能力，CLI 源碼見 github.com/dlazyai/cli。SkillHub 標籤 requires_api_key=true，使用前需配置 dLazy API Key。
核心功能¶
以下能力均來自技能包文檔與 SkillHub 頁面說明，可按命令行參數組合使用。
- 文生視頻 / 圖生視頻：通過
--prompt描述畫面；可選--images傳入最多 7 張參考圖（本地路徑或 URL），對應 SkillHub 強調的 text-to-video、image-to-video 場景。 - 生成模式：
--generation_mode可選frames（默認）或components；在components模式下可配合--subjects、--videos等多模態輸入（技能文檔中的 Omni 能力）。 - 畫面與質量：
--aspect_ratio（16:9 / 9:16 / 1:1）、--duration（3–15 秒）、--mode（std/pro）、--sound控制音效等。 - 任務控制：
--dry-run僅估算費用與 payload；--no-wait異步返回generateId，可用dlazy status <generateId> --wait輪詢；默認最長等待可通過--timeout調整（默認 1800 秒）。
Agent 側應執行 dlazy kling-v3-omni 獲取結果；完整參數列表以 dlazy kling-v3-omni -h 爲準。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝文檔執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將技能裝入當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 且可能無法被加載。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝本技能：
skillhub install @user_f95f21b8/dlazy-kling-v3 --dir <你的 skills 目錄>
也可讓 Agent 按 SkillHub 安裝說明 完成上述步驟。
3. 安裝並配置 dLazy CLI¶
技能元數據要求本機具備 npm / npx，並固定 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 註冊後，於 組織 API Key 頁面 創建。
典型用法¶
先查看幫助，確認當前 CLI 支持的參數：
dlazy kling-v3-omni -h
基礎圖生視頻（本地參考圖 + 提示詞）：
dlazy kling-v3-omni --prompt '提示詞內容' --image '/path/to/image.png'
使用遠程圖片 URL：
dlazy kling-v3-omni --prompt '提示詞內容' --image 'https://files.dlazy.com/image.png'
成功時 CLI 返回 JSON，outputs 中含 files.dlazy.com 上的結果 URL；異步任務需配合 dlazy status 查詢。
技能文檔列出的觸發關鍵詞包括：kling v3 omni、generate omni video、text to video, image to video（中文包另有「可靈 v3 全能版」「文生視頻、圖生視頻」等），便於 Agent 在對話中匹配本技能。
適用場景與注意¶
適合誰：需要在 IDE Agent、Claude Code 等環境裏做短視頻草稿的團隊；已接受通過 dLazy 雲端 API 計費、且願意用 API Key 管理訪問權限的開發者。
使用限制與注意：
- 網絡與數據：提示詞與參數會發往
api.dlazy.com；本地圖片/視頻路徑由 CLI 上傳至files.dlazy.com，生成結果 URL 亦託管在該域名，需閱讀 dlazy.com 服務條款。 - 餘額與鑑權：返回
code: "insufficient_balance"表示積分不足，需在 dLazy 控制台充值；unauthorized表示 Key 缺失或無效，需重新dlazy auth set。 - 命名差異：SkillHub 展示名爲 kling v3，技能包內 CLI 子命令爲
kling-v3-omni，查閱參數時以-h輸出爲準。 - SkillHub 數據（截至頁面抓取）：評分 100000，下載 1216，安裝 3；分類 design-media，版本 1.0.9。
結尾¶
kling v3 把 Kling v3 視頻生成收斂成 Agent 可執行的 dlazy kling-v3-omni 工作流：在 SkillHub 安裝技能、配置 dLazy API Key 後，即可在對話中用提示詞和參考圖生成視頻，而無需每次手寫雲端 API 封裝。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-kling-v3
- API 座標頁：https://api.skillhub.cn/user_f95f21b8/dlazy-kling-v3
