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