前言¶
短視頻、播客或小遊戲需要片頭 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）
