前言¶
短视频、播客或小游戏需要片头 BGM，但自己不会编曲，买素材库又难对上情绪和时长。传统做法是单独注册 Suno 等平台、配置 API、再把音频拖回剪辑流程。下面介绍 SkillHub 上的 AI音乐生成与配乐BGM（@beatra-ai/ai-music-bgm-gen，v1.0.1）：在 Cursor 等 Agent 对话里用自然语言描述需求或贴歌词，由 Skill 调用后端生成可试听、可下载的结果，一次固定输出 2 首候选，按次付费并取得商用授权。
这是什么¶
AI音乐生成与配乐BGM 是 SkillHub 分类 design-media 下的付费 Skill，坐标 @beatra-ai/ai-music-bgm-gen，发布者为 AI气泡音乐，来源标注为 enterprise。Skill 本身 不需要注册第三方账号、也不需要自备 API Key（页面标签 requires_api_key=false）；音乐生成能力由 Suno（suno_v5.5） 提供，输出策略为 锁定双轨（每次 2 首候选）。
它解决的是：把「写需求 → 等生成 → 拿文件」收进 Agent 对话，减少在多个产品之间切换。
核心功能¶
以下能力均来自 SkillHub 页面与官方简介，可按条核对：
- 文本驱动成曲：在对话中说明主题、风格、情绪，或直接提供歌词，可生成带人声歌曲或纯音乐 BGM。
- 双候选输出：一次任务返回 2 首，便于对比选用。
- 可试听、可下载：生成结果支持试听与下载（具体交互由 Skill 在对话中引导）。
- 按次付费与商用：微信支付 ¥1/次；付费后取得 商业使用授权，页面说明可用于变现与商用。
- 触发词：写歌、AI写歌、生成音乐、作曲、歌词成曲、配乐、做个配乐、BGM、背景音乐、片头音乐、短视频配乐、Vlog配乐、播客配乐、游戏配乐、广告歌、品牌歌等，便于在对话中唤起 Skill。
安装与启用¶
SkillHub 官方安装说明见 skillhub.md。先做 CLI 检查，再把 Skill 装到 当前 Agent 实际读取的 skills 目录（装错目录 Agent 不会加载）。
1、检查或安装 SkillHub CLI
command -v skillhub && skillhub --version
若未安装，可使用官方推荐的一键安装（完整包含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill
SkillHub 页面给出的安装提示为：依据上述安装文档，安装 @beatra-ai/ai-music-bgm-gen。命令形态如下（--dir 必须指向当前环境的 skills 目录）：
skillhub install @beatra-ai/ai-music-bgm-gen --dir <你的 Agent skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档，以你本机为准）：
| 客户端 | skills 目录示例 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
安装后按你所用 Agent 的要求重启或刷新技能列表。本 Skill 为 paid 类型，实际生成需在 Skill 流程内完成微信支付（¥1/次），与「免 API Key」指的不必自建 Suno 密钥是两件事。
典型用法¶
官方未单独给出长篇示例稿，用法与简介一致：在已启用 Skill 的对话里，用触发词或自然语言说明需求即可。可按下面两类输入组织提示（表述可改，信息尽量具体）：
纯配乐 / BGM
帮我做个配乐：30 秒左右，Lo-fi 嘻哈，轻松、适合 Vlog 日常片段，不要人声。
歌词成曲 / 品牌向歌曲
歌词成曲，流行摇滚，激昂一点，活动主题曲感觉。歌词如下：
（在此粘贴歌词）
经过上面的步骤，Agent 应引导你完成付费（若尚未支付）并返回 2 首 可试听、可下载的候选；选定后再用于剪辑、播客片头或游戏内循环等后续流程。
适用场景与注意¶
适合谁
- 需要快速试错配乐、片头片尾、广告或品牌向歌曲，但不想先折腾 Suno 账号与 API 的创作者与小团队。
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望音乐环节留在同一对话里完成的人。
使用上需注意
- 费用：每次生成 ¥1（微信支付），商用授权以 Skill 页面说明为准；批量制作前先算清次数成本。
- 能力边界：底层为 Suno suno_v5.5，风格与质量受模型与提示词影响；复杂编曲、精确到秒的结构可能需要多轮描述或多生成几次对比。
- 合规：商用以付费后取得的授权为准；对外发布前仍建议核对平台规则与版权声明习惯。
- 数据口径：SkillHub 页面统计（截至抓取时）为评分 100000、下载 4473；与第三方转载数据可能不一致，以 SkillHub 详情页 为准。
结尾¶
AI音乐生成与配乐BGM 把 Suno 双轨生成、试听下载和按次商用授权封装进 Agent Skill，免自备 API Key，适合短视频、播客、游戏与广告等配乐与成曲场景。安装与坐标：
- SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/ai-music-bgm-gen
- 官方地址：https://api.skillhub.cn/beatra-ai/ai-music-bgm-gen
- 坐标：
@beatra-ai/ai-music-bgm-gen（v1.0.1）
