AI 音乐创作

技能文档

---
name: beatra-ai-music-creator
title: AI 音乐创作
category: 内容创作
description: "从一个主题、一句歌词、一段画面或参考音频开始，用AI音乐生成和AI作曲制作原创歌曲、歌词成曲、纯音乐、BGM、视频配乐、品牌音乐、广告歌、播客片头、游戏音乐和多语言歌曲。这个AI写歌工作室会先确定曲风、情绪、结构、可唱歌词、人声和编曲方向，再使用 Suno 5.5 或你明确选择的其他模型生成可试听音频。适合AI写歌词、文字生成音乐、背景音乐生成、中文歌、双语歌曲、男女对唱和参考音频改编；生成后试听演唱、发音、时长、循环点和编曲效果，再集中优化最好的版本。"
---

# AI音乐创作

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

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

## 技能工作流

### 步骤1：先确定创作方向

进工作室先分流：成曲、翻唱、礼物歌或器乐 BGM。本包默认成曲。已有录音的翻唱或改编属于翻唱改编类工作流，礼物或场合歌属于定制赠歌类工作流，纯器乐 BGM 属于背景音乐类工作流，均不在本包范围内。

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

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

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

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

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

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

### 步骤2：选择并校验模型

本包的常规生成应设置 `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)中的示例作为参考模式，而不是固定承诺。

### 步骤3：使用参考音频

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

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

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

说明哪些特征应当保留，哪些特征应当改变。参考音频用于指导新的创作结果；生成后，应根据既定方向审听旋律、人声特征、能量、乐器和编曲。

### 步骤4：只确认一次付费边界并提交

直接且信息完整的生成要求，只授权执行一次对应请求。用户批准完整制作卡，同样只授权执行一次。不要再要求第二次确认。估价、比较、歌词审阅、方向选择或“暂不生成”都不代表批准。

付费调用前，应清楚展示模型、标题、歌词或纯音乐状态、参考音频、重要控制项，以及单次生成的范围。仅在参数最终确定后，创建长度为 1 至 128 个字符且稳定的 `client_request_id`。对提示词、歌词、纯音乐标记、标题、模型、参考音频、模型选项，或当前及未来 MCP 生成 schema 接受的任何其他参数所做的任何修改，都构成新的付费请求，需要新的请求标识与确认。已发布的 MCP 生成 schema 之外的字段会被忽略，不会改变请求标识或任务。

只提交一次 `beatra.music.generate`。保留返回的 `task_id`，并通过 `beatra.tasks.get` 轮询同一个任务。遵守返回的 `deadline_at`；如果未返回该值，则在主动轮询 30 分钟后停止，报告当前状态和恢复方法，并且不要重新提交。只有用户要求时，才通过 `beatra.tasks.cancel` 取消；如果取消与终态转换发生冲突，继续处理同一个任务。

如果提交结果不确定或任务 ID 丢失，使用 `beatra.tasks.list` 和匹配的音乐能力搜索近期任务。列表结果不包含完整请求：对每个可能匹配的任务调用 `beatra.tasks.get`，并将其 `task.input`、最终模型、参考音频和选项与保存的完整参数比较。只有参数完全相同的重试才能复用同一个 `client_request_id`。绝不能只因响应丢失或任务缓慢就创建新的付费任务。参见[任务与结果](references/tasks-and-results.md)和[计费、错误与恢复](references/billing-errors-and-recovery.md)。

### 步骤5：交付并审听音乐

任务成功后，按返回顺序展示 `task.output.clips` 中的每个条目。返回内容包含标题和歌词时一并展示，并提供 `clip.audio.url`、产物 ID、时长、MIME 类型和大小。报告真实任务标识与 `billing.net_charged_credits`。当任务返回 `task.links.assets` 时，使用该准确地址管理资产；不要编造通用网址。

只有当前环境确实能够播放音频时，才审听作曲、歌词、人声表现、发音、角色分配、编曲、结尾和制作效果。否则，即使仍应交付实际产物信息，也要明确说明尚未完成听感审查。保留成功的部分，并把最大的差距转化为一次聚焦且需要重新批准的生成。遵循[审听与迭代](references/review-and-iteration.md)。

## 按任务查阅资料

- 意图、歌词、纯音乐、多语言和参考音频路线：[意图与路线](references/intent-and-routing.md)
- 创作需求、风格、歌词写作、人声方向和语言：[创作需求与风格](references/creative-brief-and-style.md)、[歌词写作](references/lyrics-craft.md)和[人声、语言与标签](references/vocal-language-and-tags.md)
- 当前模型选择与准确参数控制：[模型路线](references/model-routing.md)
- 请求模式与聚焦的成品审听：[音乐方案](references/music-recipes.md)和[审听与迭代](references/review-and-iteration.md)
- 首次安装或授权过期：[安装与授权](references/installation-and-auth.md)
- 随包命令语法与排查：[随包 MCP Client 连接诊断](references/mcp-connection.md)
- 任务恢复、计费与返回结果：[任务与结果](references/tasks-and-results.md)和[计费、错误与恢复](references/billing-errors-and-recovery.md)

## 随包客户端说明

每个远程操作都只通过随包 `scripts/mcp_client.py` 调用。客户端不联网检查更新，也不上报安装信息；首次使用或连接过期时运行 `python3 scripts/authorize.py` 完成一次浏览器授权即可。

使用说明

# AI 音乐创作

从一个主题、一句歌词、一段画面或参考音频开始，用 AI 音乐生成制作原创歌曲、歌词成曲、纯音乐、BGM、广告歌、播客片头和多语言歌曲。

## 使用

首次使用先完成一次浏览器授权（只需一次）：`python3 scripts/authorize.py`。然后直接描述需求，例如：

```text
给我奶茶店写一首 30 秒的广告歌，轻快温暖，女声
把这段歌词谱成一首城市流行风的歌
参考这段伴奏，改编一个更明亮的版本
```

技能会先确定曲风、情绪、结构、歌词与人声方向，出示制作卡，经你确认后生成可试听音频，再集中优化最好的版本。

## 工作原理

所有生成通过随包客户端 `scripts/mcp_client.py` 以 MCP 协议调用服务端完成，默认使用 Suno 5.5 模型，参考音频先经专用上传命令转为产物引用。歌词创作、模型查询与评析均免费，只有音乐生成为付费步骤；生成后逐项审听演唱、发音、时长与编曲效果。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。