前言¶
在 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
