AI音乐生成与写歌

SKILL.md 节选

# AI音乐创作

把主题、场景、歌词片段、完整歌词、功能性音乐需求或参考录音发展成一个连贯的音乐方向；当用户需要音频时，再据此发起一次意图明确的生成请求。交付物可以是歌曲、纯音乐、BGM、配乐、广告歌、多语言作品或基于参考音频的新编曲。把歌手身份、发音、精确时长、循环点、旋律延续和母带处理视为生成后需要审听的质量，而不是能够保证的属性。

所有 Beatra 操作都只能通过随包 `scripts/mcp_client.py` 执行。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。普通调用运行 `python3 scripts/mcp_client.py call <tool-name>`，并通过 stdin 传入一个 JSON 对象。本地文件只能使用下文所述的专用上传命令。仅当随包路径需要排查时，参见[随包 MCP Client 连接诊断](references/mcp-connection.md)。

## 先确定创作方向

进工作室先分流：成曲、翻唱、礼物歌或器乐 BGM。本包默认成曲。已有录音的翻唱或改编走 `ai-song-cover-studio`，礼物或场合歌走 `personalized-song-maker`，纯器乐 BGM 走 `short-video-bgm-studio`。

复用对话中所有已确定的选择。在安全的前提下，根据作品用途推断常规创作细节。硬输入是主题或歌词，加上用途。曲风为空时，先问再写制作卡。只有缺失的信息会改变歌词、参考方向、人声或纯音乐路线、实际付费参数，或其他由用户决定且影响重大的选择时，才提问。

黄金路径：锁定结构，写可执行 caption，产出有限 take，再做一次聚焦调整。禁止自动连发 Extend。

生成前，准备一张简洁的制作卡：

- 用途与听众；
- 标题、核心构想、情绪变化、主要曲风、速度感、乐器、结构、混音方向、结尾或循环方向，以及排除项；
- 人声或纯音乐路线；
- 作品含人声时的完整歌词、语言与语体，以及人声方向；
- 所选模型及其专属控制项；
- 涉及参考音频时的参考意图，以及应保留或改变的特征；以及
- 下一步操作会产生一次付费生成的事实。

制作纯音乐时省略歌词，并在创作方向中为对白或其他功能需求留出空间。制作人声音乐时，在生成前完成并展示重要的歌词修改。歌词创作、创意策划、模型查询、提示词准备和评析都不需要付费音乐调用。参见[意图与路线](references/intent-and-routing.md)、[创作需求与风格](references/creative-brief-and-style.md)、[歌词写作](references/lyrics-craft.md)和[人声、语言与标签](references/vocal-language-and-tags.md)。

当需求使用某位艺人的简称来描述风格时，将其转化为可执行的曲风、年代、速度、乐器、和声、人声质感、乐句处理和混音特征。

## 选择并校验模型

本包的常规生成应设置 `model: "suno-5.5"`。绝不能省略模型，也不能静默使用 `auto`。当用户要求使用其他模型、询问当前可用性或价格，或需要某个模型的专属能力时，调用 `beatra.models.list`，并使用 `text_to_music` 或 `reference_audio_to_music` 能力。不要静默替换模型。

只使用所选模型系列实际返回或文档中列出的控制项。Suno 与 MiniMax 的选项不能互换。通过[模型路线](references/model-routing.md)校验准确参数，并把[音乐方案](references/music-recipes.md)中的示例作为参考模式，而不是固定承诺。

## 使用参考音频

对于本地 FLAC、MP3 或 WAV 参考音频，只能运行：

```text
python3 scripts/mcp_client.py upload <path> --mime-type <type>
```

随包命令会获取并校验上传授权，逐字节上传该文件，并返回可用作 `reference_audio` 的产物。不要用宿主 HTTP、Connector、REST，或手写授权与 PUT 流程替代它。通用上传上限为 100 MB；所选音乐模型可能设置更低的文件大小或时长限制。

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 20 个文件，合计 202.3 KiB