前言¶
做視頻、播客、遊戲或品牌物料時，往往需要一段原創 BGM、片頭曲或完整歌曲。自己從零寫詞編曲成本高，直接在 Suno 等工具裏反覆試錯，又缺少「先定曲風、結構、人聲再生成」的連貫流程。下面介紹 SkillHub 上的 @beatra-ai/beatra-ai-music-creator（AI音樂生成與寫歌），它把「寫歌工作室」式的步驟寫進 Skill，讓 Agent 按同一套節奏幫你從靈感落到可試聽音頻。
這是什麼¶
AI音樂生成與寫歌 是 beatra 發佈的企業源 Skill（design-media 分類），當前版本 1.4.1，座標 @beatra-ai/beatra-ai-music-creator。頁面標註 requires_api_key=false，即 Skill 本身不要求在 SkillHub 側配置 API Key（具體生成仍依賴 Skill 內說明的模型與賬號，以 SKILL.md 爲準）。
定位上，它是一個 AI 寫歌工作室：可從主題、一句歌詞、畫面描述或參考音頻起步，完成 AI 音樂生成與 AI 作曲，產出原創歌曲、歌詞成曲、純音樂、BGM、視頻配樂、品牌音樂、廣告歌、播客片頭、遊戲音樂及多語言歌曲等。
- 官方 API 入口：https://api.skillhub.cn/beatra-ai/beatra-ai-music-creator
- SkillHub 展示頁：https://www.skillhub.cn/skills/beatra-ai/beatra-ai-music-creator
SkillHub 頁面顯示評分 100000，下載 112168 次（數據以頁面爲準，會隨時間變化）。
核心功能¶
以下能力均來自官方簡介，未在資料中出現的細節不展開。
輸入形態¶
可從多種起點觸發創作：
- 主題或概念
- 單句或完整歌詞
- 畫面、場景描述
- 參考音頻（含改編方向）
創作前的結構化決策¶
生成前會先對齊創作參數，而不是直接丟一句 prompt 給模型：
- 曲風、情緒
- 歌曲結構
- 可演唱歌詞（含 AI 寫歌詞場景）
- 人聲方向（含男女對唱、雙語等）
- 編曲方向
生成與模型¶
在方向確定後，使用 Suno 5.5，或你 明確指定的其他模型，生成 可試聽 的音頻。
生成後的迭代¶
官方流程強調生成後要試聽並集中優化表現最好的版本，關注點包括：
- 演唱與發音（含中文歌、多語言）
- 時長與循環點（BGM、遊戲、視頻配樂常用）
- 編曲與整體聽感
適用方向在簡介中明確列出：文字生成音樂、背景音樂生成、參考音頻改編、品牌與廣告音樂等。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式。安裝方式以 SkillHub 頁面與安裝文檔爲準。
方式一：讓 Agent 按文檔安裝¶
將下面提示發給已支持 Skill 的 AI 客戶端（Cursor、Claude Code、Codex CLI 等），由 Agent 讀取安裝說明並執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@beatra-ai/beatra-ai-music-creator`。
方式二：使用 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（文檔推薦）或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Skill 時 必須 使用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，客戶端可能無法加載。常用路徑如下（摘自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
示例（將 <skills 目錄> 換成上表對應路徑）：
skillhub install @beatra-ai/beatra-ai-music-creator --dir <skills 目錄>
安裝後按各客戶端要求刷新或重啓，使新 Skill 被識別。首次配置 SkillHub 爲優先源、沙箱聯網等細節見 https://skillhub.cn/install/skillhub.md 。
典型用法¶
公開頁面未附帶完整對話實錄；典型用法可按官方簡介中的 工作室流程 復現，由 Agent 讀取已安裝的 SKILL.md 執行具體步驟與工具調用。
- 說明起點：給出主題、歌詞片段、畫面描述，或上傳/指明參考音頻及改編意圖（例如「保留節奏，換成中文流行女聲」）。
- 確認創作單：與 Agent 一起定曲風、情緒、段落結構、歌詞是否可唱、人聲與編曲方向；需要雙語、對唱或純器樂時在此寫明。
- 選擇生成後端：默認走 Suno 5.5；若你有其他模型要求，在對話中明確指定。
- 試聽與篩選：對返回的可試聽音頻檢查演唱、發音、長度、循環是否適合成片，以及編曲是否貼合用途（BGM 循環、廣告 15/30 秒感、遊戲氛圍等）。
- 集中優化：保留表現最好的版本，在同一創作單上微調歌詞、結構或編曲描述後再次生成，而不是從零換 prompt。
以上第 1～5 步對應簡介中的「先確定方向 → 再生成 → 再優化」，具體 prompt 模板、導出格式以 Skill 包內 SKILL.md 爲準。
適用場景與注意¶
適合誰
- 需要快速出 demo 曲、片頭、廣告歌或遊戲/視頻配樂的創作者與小團隊
- 希望用 Agent 統一「寫詞 + 定結構 + 選模型 + 迭代試聽」流程的人
- 做中文歌、雙語、男女對唱或參考曲改編，且願意在生成後做聽感驗收的場景
使用注意
- 版本與下載數據以 SkillHub 頁面爲準（當前 v1.4.1）。
requires_api_key=false僅表示 SkillHub 標籤層面的要求；實際音樂生成仍取決於 Skill 內配置的模型服務與賬號，安裝後應閱讀SKILL.md中的前置條件。- 版權、商用授權、平臺條款需自行對照生成服務（如 Suno）及 beatra Skill 說明，本文不替代法律或平臺協議。
- 企業源（
enterprise）Skill，若在團隊環境使用，建議統一安裝目錄與版本，避免成員本地 Skill 不一致導致流程分叉。
結尾¶
AI音樂生成與寫歌 把「定曲風、結構、歌詞與人聲 → Suno 5.5 或其他模型成曲 → 試聽並優化」寫進 Agent Skill，減少在多個工具間手工對齊參數的碎片時間。若你正在找從一句話或一段畫面到可試聽成曲的流水線，可在 SkillHub 查看並安裝：
- https://www.skillhub.cn/skills/beatra-ai/beatra-ai-music-creator
- https://api.skillhub.cn/beatra-ai/beatra-ai-music-creator
