前言¶
要在对话式环境里生成 AI 音乐，常见做法是单独打开百音开放平台或 SUNO 相关控制台，手工提交任务、再回来查状态和下载链接。流程割裂时，Agent 很难在一次会话里完成「提需求 → 等任务 → 拿结果」。
下面介绍 SkillHub 上的社区 Skill baiyin-music-generate（坐标 @user_7b3c719e/baiyin-music-generate，当前版本 1.0.5）。它把百音开放平台的 AI 音乐任务（SUNO 音乐生成）封装进通用 SKILL.md 格式，让 Cursor、Claude Code、Codex 等支持 Skills 的客户端，在同一 Skill 内完成创建任务、查进度、取结果链接和查余额。
这是什么¶
baiyin-music-generate 归类为 SkillHub 的 design-media，来源为 community，由发布者 user_7b3c719e 维护。
一句话定位：通过百音开放平台创建 SUNO 类 AI 音乐任务，并在同一 Skill 内查询任务状态、结果链接与账户余额。官方页面标注标签 requires_api_key=true，使用前需要准备百音开放平台的 API 密钥（具体申请与配置方式以百音平台文档及 Skill 安装后的说明为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介，未单独展开的实现细节以安装后的 Skill 内容为准。
- 普通生成：按文本等条件创建 AI 音乐生成任务。
- 参考音频生成：在提供参考音频的前提下生成音乐。
- 音乐改编：对已有作品进行改编类任务。
- 任务与账户：查询音乐任务进度、获取结果链接，以及查询余额。
适用意图包括：用户要生成歌曲、用参考音频做歌、改编上一首歌、查询音乐任务进度或下载结果。
安装与启用¶
安装前建议确认本机已安装 SkillHub CLI。SkillHub 安装文档给出的检查方式如下：
command -v skillhub && skillhub --version
若未安装，可按官方安装脚本安装（完整安装或仅 CLI，以 SkillHub 安装说明 为准）。
SkillHub 页面给出的安装指引是：根据 https://skillhub.cn/install/skillhub.md，安装坐标 @user_7b3c719e/baiyin-music-generate。对应 CLI 操作需使用 --dir 指向当前 Agent 的 skills 目录，否则默认目录可能不会被客户端加载。
在 Cursor 中，常见 skills 目录为 ~/.cursor/skills/。示例：
skillhub install @user_7b3c719e/baiyin-music-generate --dir ~/.cursor/skills/
其他客户端路径以安装文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。安装后按你所用客户端的要求重启或刷新 Skills，并配置百音 API Key（Skill 标注需要 API 密钥）。
典型用法¶
官方未在商店页粘贴完整对话脚本，用法应结合自然语言意图与 Skill 内工具说明。与简介一致的可复现方向如下：
- 生成新歌：向 Agent 说明风格、主题或歌词方向，请求通过百音创建普通 SUNO 音乐生成任务。
- 参考音频做歌：提供参考音频或说明参考来源，请求创建「参考音频生成」类任务。
- 改编：在已有上一首或指定作品语境下，请求「音乐改编」任务。
- 跟进任务：在同一会话中查询任务状态、获取结果链接；需要时查询百音账户余额。
经过上面的步骤，Agent 应依据 Skill 调用百音开放平台接口，而不是在本地伪造音频文件。具体参数名、轮询间隔以 Skill 包内文档为准。
适用场景与注意¶
适合谁：需要在 IDE 或 CLI Agent 里做 AI 音乐生产、改编和任务跟进的开发者或创作者；已具备或愿意申请百音开放平台 API Key 的用户。
限制与注意：
- 依赖外网百音开放平台与 SUNO 类生成能力，需遵守平台条款与计费规则；Skill 内提供余额查询，便于控制用量。
- 社区来源（community），版本 1.0.5；升级可用
skillhub在对应 skills 目录下更新，并关注 SkillHub 页变更。 - SkillHub 展示评分 100000、下载约 769 次（页面统计会变动），仅作发现参考，不代表音质或 SLA 承诺。
- 未配置 API Key 时，Skill 无法完成真实调用。
结尾¶
baiyin-music-generate 把百音 SUNO 音乐生成的提交、改编、参考音频、任务查询与余额查看收拢到一个 Skill，减少在平台和 Agent 之间来回切换。安装与坐标以 SkillHub 为准。
- API 入口页：https://api.skillhub.cn/user_7b3c719e/baiyin-music-generate
- SkillHub 展示页：https://www.skillhub.cn/skills/user_7b3c719e/baiyin-music-generate
