前言¶
短视频、有声内容和多语言配音里，经常需要「固定音色 + 新文案」：自己录一遍参考音，再让系统按新文本读出同样声线。若每次都在控制台里查参数、拼请求，Agent 很难稳定复现同一套流程。
下面介绍 SkillHub 上的社区 Skill vidu audio clone（坐标 @user_f95f21b8/dlazy-vidu-audio-clone，当前版本 1.0.9）。它把 dLazy 托管的 Vidu Audio Clone 能力封装成标准 SKILL.md，让 Cursor、Claude Code 等客户端在对话里按文档调用 CLI，完成参考音频上传、音色克隆和新文本朗读生成。
这是什么¶
vidu audio clone 的定位是：使用 Vidu 声音克隆技术，通过参考音频复制音色，并生成新文本的朗读音频。SkillHub 分类为 design-media，来源为 community，发布者为 user_f95f21b8。
底层由 dlazyai 维护的 @dlazy/cli 调用 dLazy API（api.dlazy.com），不是本地离线模型。Skill 标签标明 requires_api_key=true，使用前需要有效的 dLazy API Key。
核心功能¶
结合官方简介与技能包 SKILL-cn.md，可核实的能力包括：
- 声音克隆：通过
--audio_url传入参考音频（URL 或本地路径），作为音色依据。 - 文本朗读生成：通过
--prompt传入要朗读的文本内容（技能文档中该字段标注为「提示词」）。 - CLI 辅助：支持
dlazy vidu-audio-clone -h查看参数；--dry-run预估请求与费用；--no-wait与dlazy status处理异步任务；--timeout控制等待上限（默认 1800 秒）。 - Agent 触发词（技能内定义）：如「vidu 声音克隆」「克隆声音」「定制语音」。
生成结果以 API 返回的 URL 形式给出（托管在 files.dlazy.com）。本地参考音频会先由 CLI 上传到 dLazy 媒体存储，与常见云端生成 API 流程一致。
安装与启用¶
1. 安装 Skill 到当前 Agent¶
SkillHub 页面建议让 Agent 按 SkillHub 安装说明 安装本技能。若已安装 skillhub CLI，需用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/ 可能不会被识别：
command -v skillhub && skillhub --version
未安装 CLI 时，可按官方脚本安装（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill（将 dlazy-vidu-audio-clone 装到对应目录）：
skillhub install dlazy-vidu-audio-clone --dir <skills 目录>
常用客户端 skills 路径示例（以安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中直接提示 Agent：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f95f21b8/dlazy-vidu-audio-clone。
2. 安装并配置 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 auth set YOUR_API_KEY
Key 写入 ~/.dlazy/config.json（Windows 为 %USERPROFILE%\.dlazy\config.json），也可单次使用环境变量 DLAZY_API_KEY。Key 在 dlazy.com/dashboard/organization/api-key 获取。
典型用法¶
先确认帮助信息与必填项：
dlazy vidu-audio-clone -h
文档列出的主要参数为 --audio_url（参考音频）与 --prompt（朗读文本）。基础调用示例（与技能包一致）：
dlazy vidu-audio-clone --prompt '提示词内容'
实际克隆场景应同时提供参考音频与待读文本，例如：
dlazy vidu-audio-clone --audio_url '/path/to/reference.wav' --prompt '需要朗读的新文案'
在 Agent 中启用本 Skill 后，模型会按 SKILL.md 执行上述命令；遇到余额或鉴权错误时，技能文档要求引导用户至 dLazy 控制台充值或更新 Key。
成功时 CLI 返回 JSON，result.outputs 中含生成资源的 url 等字段；若使用 --no-wait，需用 dlazy status <generateId> --wait 轮询完成状态。
适用场景与注意¶
适合：已在用 Cursor / Claude Code 等支持 Skills 的环境，需要把「参考音 + 新脚本 → 朗读音频」交给 Agent 编排；愿意使用 dLazy 积分与云端 API 的团队或个人。
限制与注意：
- 联网与合规：提示词、参数及本地媒体文件会发往 dLazy；使用前请阅读 dlazy.com 服务条款，并确保参考音频与生成内容有权使用。
- 费用：调用消耗 dLazy 账户积分；
insufficient_balance时需到组织设置中充值。 - 依赖：需 Node 生态下的
@dlazy/cli@1.0.9；全局安装前可在 github.com/dlazyai/cli 审阅源码。 - SkillHub 数据（抓取时点）：评分 100000，下载 1036，安装计数 0；以 SkillHub 技能页 为准。
结尾¶
vidu audio clone 把 Vidu 声音克隆与文本朗读收敛成一条可重复的 Agent 工作流：Skill 负责说明与约束，dLazy CLI 负责鉴权与 API 调用。若你要在 Agent 里一键完成「克隆音色并读新稿」，可从 SkillHub 安装 @user_f95f21b8/dlazy-vidu-audio-clone，并配置好 dLazy API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-vidu-audio-clone
- API 坐标页：https://api.skillhub.cn/user_f95f21b8/dlazy-vidu-audio-clone
