前言¶
要在对话式 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
