前言¶
在开发需要 AI 歌手翻唱能力的应用时,最直接的痛点是:如何把用户发起的翻唱请求对接到百音开放平台的 API,并在后续获取任务状态与最终音频结果。常见的做法是自行封装 HTTP 调用、维护 taskId 与状态映射,这在对接多个任务或需要高可用性时容易出错且开发成本高。下面介绍一个基于百音开放平台的 Skill,用于创建翻唱任务、查询任务状态,并获取最终音频结果。
这是什么¶
这是一个基于 SKILL.md 标准格式的 Skill,由用户 @user_7b3c719e 在 SkillHub 上发布,版本为 1.0.5,分类为 ai-agent。它封装了与百音开放平台交互的核心逻辑,帮助开发者通过 SkillHub 生态快速接入翻唱能力,无需从零构建 HTTP 客户端与状态管理。
核心功能¶
这个 Skill 提供了三个主要能力:
- 创建 AI 歌手翻唱任务:接收用户输入,向百音开放平台发起创建任务请求,返回 taskId。
- 查询翻唱任务状态:根据 taskId 查询任务当前执行状态。
- 获取最终翻唱音频结果:根据 taskId 返回最终的音频文件(通常是音频 URL 或文件)。
这些能力覆盖了从任务创建到结果获取的全链路。
安装与启用¶
SkillHub 目前支持通过 Cursor 等编辑器集成。在支持的编辑器中,可以通过以下方式安装:
- 打开编辑器的插件/扩展市场,搜索 baiyin-cover-sing-skill。
- 找到由 @user_7b3c719e 发布的 Skill,点击安装。
安装完成后,在编辑器中即可按约定调用该 Skill。具体命令格式与参数需参考 Skill 提供的 SKILL.md 文档。
典型用法¶
下面给出基于官方描述的可复现流程示例:
- 用户发起创建翻唱任务请求,包含歌曲与歌手等信息。
- Skill 接收请求,调用百音开放平台 API 创建任务,获取 taskId。
- 用户后续可查询任务状态,Skill 将 taskId 与状态映射返回。
- 任务完成后,用户请求获取结果,Skill 根据 taskId 拉取最终音频。
适用场景与注意¶
- 适用场景:需要快速集成百音开放平台翻唱能力的项目,如音乐社交应用、歌词与音频生成工具等。
- 注意事项:该 Skill 需要有效的 API Key(官方标注 requires_api_key=true),请确保在调用前已配置正确的凭证。此外,最终音频的获取可能受百音开放平台的限流与配额影响。
短结尾¶
这个 Skill 封装了与百音开放平台交互的核心逻辑,为开发者提供了一站式的翻唱任务接入方案。官方地址:https://api.skillhub.cn/user_7b3c719e/baiyin-cover-sing-skill