前言¶
在 IDE 或对话式 Agent 里做视频，常见做法是单独打开控制台、手写 HTTP 请求或切到第三方网页，提示词、参考图和参数很难和当前任务上下文连在一起。若希望 Agent 在对话中直接发起文生视频、图生视频，并把结果以可下载 URL 返回，需要一份约定好的 Skill 说明书，而不是零散的 API 文档。
下面介绍 SkillHub 社区技能 veo 3.1（坐标 @user_f95f21b8/dlazy-veo-3-1）：它把 Google Veo 3.1 的生成能力封装进通用 SKILL.md 格式，通过 dLazy CLI 调用托管 API，适合已具备 API Key、希望在 Cursor 等客户端里用自然语言驱动视频生成的开发者。
这是什么¶
veo 3.1 的定位是：使用 Google Veo 3.1 生成高质量、偏电影特效风格的视频，支持文生视频与图生视频（Skill 中文说明中的表述）。
- 发布渠道：SkillHub，来源标记为
community，发布者账号为user_f95f21b8，当前版本 1.0.9，分类 design-media。 - 运行时依赖：Skill 元数据要求本机具备
npm/npx，并安装或按需调用 @dlazy/cli@1.0.9；CLI 维护方为 dlazyai，源码见 github.com/dlazyai/cli。 - 鉴权：SkillHub 标签
requires_api_key=true；实际请求使用 dLazy API Key，经dlazy auth set写入~/.dlazy/config.json，或通过环境变量DLAZY_API_KEY传入。
Skill 本身是 dLazy 托管 API（api.dlazy.com、files.dlazy.com）的薄封装：提示词与参数发往 API，本地图片路径由 CLI 上传至媒体存储，生成结果以 URL 形式返回。
核心功能¶
以下能力均来自 Skill 自带的 SKILL.md / SKILL-cn.md，未在文档中出现的能力不写。
- 文本驱动生成：通过
--prompt提交提示词（必填）。 - 两种生成模式（
--generation_mode，默认frames）：
-frames：首帧 / 尾帧图生视频（--firstFrame、--lastFrame）。
-components：最多 3 张参考图（--images）。 - 画幅与清晰度：
--size支持16:9、9:16；--resolution支持720P、1080P、4K。 - 调试与异步：
--dry-run可打印请求体与费用估算而不真正调用；--no-wait立即返回generateId，可用dlazy status <generateId> --wait轮询；--timeout默认最长等待 1800 秒。 - Agent 侧约定：触发词包括
veo 3.1、generate video、文生视频 / 图生视频等；执行结果以 JSON 信封返回（tool: "veo-3.1"，modelId: "veo_3_1"）。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 1058 次，安装计数 0（平台展示字段，不代表本地是否已装）。
安装与启用¶
安装分两层：先把 Skill 装进 Agent 的 skills 目录，再准备 dLazy CLI 与 API Key。
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 将 veo 3.1 安装到当前 Agent 的 skills 目录¶
SkillHub 页面给出的安装提示为：依据 skillhub.cn/install/skillhub.md，安装坐标 @user_f95f21b8/dlazy-veo-3-1。命令行示例：
skillhub install @user_f95f21b8/dlazy-veo-3-1 --dir <你的 Agent skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
--dir 必须指向当前客户端实际识别的目录，否则 Skill 不会被加载。
也可把下面提示词发给支持 Skill 的 AI，由其按官方安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f95f21b8/dlazy-veo-3-1`。
3. 安装 dLazy CLI 并配置 Key¶
全局安装（与 Skill 元数据 pinned 版本一致）：
npm install -g @dlazy/cli@1.0.9
或按需调用、不持久化全局包：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（在 dlazy.com/dashboard/organization/api-key 获取）：
dlazy auth set YOUR_API_KEY
经过上面的步骤，Agent 读取 Skill 后应执行 dlazy veo-3.1 完成实际生成；OpenClaw 类客户端的系统提示亦指向 dlazy veo-3.1 -h 查看帮助。
典型用法¶
先看完整参数（Agent 应按 Skill 要求执行）：
dlazy veo-3.1 -h
Skill 文档中的示例（保留原文参数名；完整选项列表以 -h 为准）：
# 基础调用
dlazy veo-3.1 --prompt '提示词内容' --image '/path/to/image.png'
# 使用远程图片 URL
dlazy veo-3.1 --prompt '提示词内容' --image 'https://files.dlazy.com/image.png'
纯文生视频时，至少提供 --prompt；图生视频需按 generation_mode 选择 frames（首尾帧）或 components（多张 --images）。提交前可用 --dry-run 核对载荷与预估费用。
成功时返回结构类似：
{
"ok": true,
"result": {
"tool": "veo-3.1",
"modelId": "veo_3_1",
"outputs": [
{
"type": "image",
"id": "o_xxxxxxxx",
"url": "https://files.dlazy.com/result.png",
"mimeType": "image/png"
}
]
}
}
（示例 JSON 摘自 Skill 文档；实际 type / mimeType 以 API 返回为准。）
适用场景与注意¶
适合谁
- 已在 dLazy 开通账号、愿意用 API Key 按量计费的使用者。
- 希望在 Cursor、Claude Code、Codex 等环境中，用对话触发 Veo 3.1 文生视频 / 图生视频，而不是每次手写 curl 的团队。
限制与注意
- 网络与合规：请求发往 dLazy 云端，本地媒体会上传至
files.dlazy.com；需接受其服务条款与内容安全策略（失败时后端可能返回如 Prompt violates safety policy 等信息）。 - 余额：
code: "insufficient_balance"表示积分不足，需在 dlazy.com 充值页 处理。 - 鉴权失败：
unauthorized时需检查 Key 是否已通过dlazy auth set或DLAZY_API_KEY配置。 - 版本绑定：Skill 1.0.9 与 CLI 1.0.9 配套；升级任一侧前建议对照 SkillHub 上的新版本说明。
结尾¶
veo 3.1 把 Google Veo 3.1 的生成流程收敛成 Agent 可读的 Skill 加 dlazy veo-3.1 命令：安装坐标、配置 dLazy Key、在对话里描述画面即可发起任务。官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-veo-3-1
- API 坐标链接：https://api.skillhub.cn/user_f95f21b8/dlazy-veo-3-1
更多 CLI 与计费说明见 dlazy.com。
