前言¶
用百音开放平台做语音,通常要自己写脚本:拼请求体、传文本、拿任务 ID、隔几秒轮询一次状态、解析结果里的音频链接。任务一多,这些代码就散落在各个项目里,换台机器还得重写。下面介绍的这个 Skill 把「创建任务 → 查询状态 → 取结果链接」压在同一个入口里,让 Agent 能直接按对话完成这些动作,不用自己维护脚本。
这是什么¶
baiyin-voice-generate-skill 是一个社区发布的 Skill,坐标 @user_7b3c719e/baiyin-voice-generate-skill,版本 1.0.5,由 user_7b3c719e 维护,在 SkillHub 上归入 design-media 分类。它解决的问题是:把百音开放平台的语音任务流程封装成 Agent 可调用的能力,用户只要说出意图,剩下的创建和查询由 Skill 完成。
官方地址:https://api.skillhub.cn/user_7b3c719e/baiyin-voice-generate-skill
SkillHub 页面:https://www.skillhub.cn/skills/user_7b3c719e/baiyin-voice-generate-skill
核心功能¶
以下能力来自官方简介,属已核实内容:
- 通过百音开放平台创建 AI 语音任务。
- 文本转语音:把一段文字转成语音。
- 音色克隆:针对需要自定义音色的场景。
- 在同一 Skill 内继续查询任务状态。
- 在同一 Skill 内获取结果链接,用于下载。
也就是说,创建、轮询、取链接三步都在这一个 Skill 里,不需要切到别的工具。
安装与启用¶
已抓取资料中没有给出安装命令、目录路径或配置文件字段,这部分无法核实,因此不在这里写。按通用 SKILL.md 格式的 Skill 一般需要放进 Skill 目录后由 Agent 识别,具体方式以官方页面为准。
有一点可以确认:该 Skill 带有 requires_api_key=true 标签,说明启用前需要准备好百音开放平台的 API key。key 的字段名和放置位置,资料中没有列出,需要到官方页面确认后再配置。
典型用法¶
资料中没有提供带参数的完整调用示例,下面这四类请求来自官方简介的描述,属于使用场景而非命令,实际参数需在安装后按 Skill 的 SKILL.md 说明填写:
1、用户要生成语音时,传入文本,由 Skill 创建文本转语音任务。
2、用户要克隆音色时,由 Skill 发起音色克隆任务。
3、任务已创建、用户想知道进度时,在同一 Skill 内查询任务状态。
4、任务完成、用户需要音频时,在同一 Skill 内拿到结果链接并下载。
适用场景与注意¶
适合的场景:已经在用 Agent 跑流程、希望语音生成不离开对话上下文的人;以及需要文本转语音和音色克隆两类能力、又不想分别对接平台接口的人。
需要注意的几点:
- 需要自备百音开放平台的 API key,没有 key 无法跑通。
- 该 Skill 来自 community 来源,不是平台官方出品,接入生产前建议先自测一遍任务创建和结果下载。
- 版本为 1.0.5,属于早期版本,接口行为后续可能调整。
- SkillHub 上的评分是 100000,下载 516 次,安装 1 次。这几个数字是 SkillHub 页面的统计口径,含义以 SkillHub 为准。
结尾¶
这个 Skill 的价值在于把百音语音任务的三步流程收进一个入口,Agent 侧不用额外写脚本。如果你的场景正好落在文本转语音、音色克隆或任务查询上,可以先按官方页面配置 API key 试跑一条任务,确认链路通了再接到自己的流程里。
官方地址:https://api.skillhub.cn/user_7b3c719e/baiyin-voice-generate-skill