前言¶
做短视频旁白、产品演示或无障碍朗读时，往往需要把稿子快速变成可下载的音频。本地 TTS 要挑引擎、调音色；直接对接云厂商 API 又要自己写鉴权、参数和错误处理。若你希望 Agent 在对话里根据 --prompt 选音色、语速和格式，并把结果以 URL 返回，可以把 SkillHub 上的 keling tts（坐标 @user_f95f21b8/dlazy-keling-tts，当前版本 1.0.9）装进 Cursor、Claude Code 等客户端的 skills 目录，由技能文档驱动 dlazy keling-tts 调用。
下面介绍这个 Skill 的定位、能力与安装用法；事实依据 SkillHub 页面与技能包内 SKILL.md / SKILL-cn.md。
这是什么¶
keling tts 是社区来源（community）、分类为 design-media 的 Agent Skill。SkillHub 简介为：Convert text into high-quality, emotional speech reading using Kling TTS. 中文说明为：使用可灵（Kling）TTS 模型，将文本转化为高质量、情感丰富的语音朗读。
技能在 SkillHub 由发布者 user_f95f21b8 上架；底层通过 dlazyai 维护的 @dlazy/cli（技能元数据固定版本 1.0.9）访问 dLazy 托管 API（api.dlazy.com、files.dlazy.com）。标签 requires_api_key=true：使用前必须配置 dLazy API Key，按次或按账户计费，具体以 dlazy.com 服务条款为准。
核心功能¶
结合官方技能文档，可核实的能力包括：
- 文本转语音：通过
dlazy keling-tts，必填--prompt传入待朗读文本。 - 语言与音色：
--voice_language支持zh、en（默认zh）；--voiceId随语言变化，默认genshin_vindi2，中文侧含新闻播报、方言人设、儿童音等大量预设（完整列表见dlazy keling-tts -h）。 - 输出控制：
--speed可选0.8、1.0、1.5；--format可选mp3、wav（默认mp3）。 - 调试与异步：
--dry-run可打印请求载荷与费用估算而不真正调用 API；--no-wait可立即返回generateId，再用dlazy status <generateId> --wait轮询。 - 管道参数：各 flag 支持
-、@N、@stdin等管道引用，详见dlazy --help。
Agent 侧触发关键词包括：kling tts、text to speech、generate speech（中文文档另有「可灵 tts」「文本转语音」「生成语音」）。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查或安装 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 将 keling tts 装进当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能读不到。常见路径（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例命令（将目录替换为你的环境）：
skillhub install @user_f95f21b8/dlazy-keling-tts --dir ~/.cursor/skills/
也可让 AI 按 https://skillhub.cn/install/skillhub.md 安装 @user_f95f21b8/dlazy-keling-tts。装好后通常需重启或刷新 Agent 以加载技能。
3. 安装并配置 dLazy CLI¶
技能要求本机具备 npm / npx。全局安装固定版本：
npm install -g @dlazy/cli@1.0.9
或按需调用、不常驻全局：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（写入 ~/.dlazy/config.json，Windows 为 %USERPROFILE%\.dlazy\config.json）：
dlazy auth set YOUR_API_KEY
也可在单次调用时设置环境变量 DLAZY_API_KEY。Key 在 dlazy.com/dashboard/organization/api-key 获取。
典型用法¶
先查看子命令帮助，确认当前环境下的参数与音色列表：
dlazy keling-tts -h
官方文档中的基础示例：
dlazy keling-tts --prompt '提示词内容'
在 Agent 对话中，等价于让模型执行上述命令；你可补充例如中文女声、略慢语速、WAV 格式：
dlazy keling-tts \
--prompt '大家好，这是一段测试旁白。' \
--voice_language zh \
--voiceId chat1_female_new-3 \
--speed 0.8 \
--format wav
调用前可用 --dry-run 查看载荷与费用估算。成功时 CLI 返回 JSON，result.tool 为 keling-tts，result.modelId 为 keling-tts，outputs 中含托管在 files.dlazy.com 的结果 URL（技能文档中的示例 JSON 仍使用通用 type 字段，以实际返回为准）。
适用场景与注意¶
适合谁
- 已在用 Cursor / Claude Code 等支持 Skills 的环境，希望用自然语言描述「把这段稿子读出来」并拿到音频链接。
- 需要可灵 TTS 的多音色、中英文切换，且接受通过 dLazy 账户计费的用户。
限制与注意
- 必须联网且有 API Key：未配置或 Key 无效会返回
code: "unauthorized"；余额不足为insufficient_balance，需到 Credits 设置 充值。 - 文本会上传到云端：提示词与参数发往
api.dlazy.com，属于标准 SaaS 调用，敏感内容需自行评估合规性。 - 依赖 Node 生态：需能运行
npm/npx并安装@dlazy/cli@1.0.9；安装 CLI 前可参考 github.com/dlazyai/cli 审阅源码。 - SkillHub 元数据：截至抓取时，该 Skill 评分为 100000，下载约 1047 次，安装记录 2 次；页面数据会变动，以 SkillHub 为准。
常见错误码见技能文档（如缺少 --prompt、本地文件路径错误、异步任务失败等）；Agent 应按文档在余额与鉴权失败时给出明确指引。
结尾¶
keling tts 把可灵 TTS 封装成 Agent 可执行的 dlazy keling-tts 工作流：Skill 负责触发词与参数说明，CLI 负责鉴权与 API 调用。若你要在 IDE 里用对话生成带情感的朗读音频，可先按上文安装 Skill 与 @dlazy/cli@1.0.9，再配置 dLazy API Key。
官方入口：
