AI音乐生成与写歌

音乐创作涉及从概念到成品的复杂流程，普通用户常因缺乏专业工具或技能而受阻。本技能通过 AI 将主题、歌词片段或参考录音转化为可执行的音乐方向，并生成歌曲、纯音乐、BGM 等作品，覆盖广告歌、多语言制作等场景。

需要解决的具体问题

当用户有音乐想法但无法独立完成制作时，例如：

• 提供主题或歌词片段，需要生成一首结构完整的歌曲。
• 基于参考音频（如录音），创作新的编曲或风格改编。
• 生成功能性音乐，如背景配乐、广告旋律或循环 BGM，支持多语言版本。

技能如何工作

技能依赖 Beatra 工具链，通过 MCP 客户端执行命令，核心步骤如下：

1. 确定创作方向：首先区分任务类型，如 ai-song-cover-studio（翻唱）或 short-video-bgm-studio（纯器乐 BGM），本包默认处理成曲。复用对话中已确定信息，仅在缺失关键选择（如人声 vs 纯音乐）时提问。

1. 准备制作卡：生成前创建简洁的制作卡，包含用途、听众、标题、情绪变化、曲风、速度、乐器、结构等。例如，曲风为空时需先询问，再写制作卡。歌词创作或模型查询不产生费用。

1. 选择并校验模型：默认使用 model: "suno-5.5"，绝不能省略或静默替换为 auto。调用 beatra.models.list 根据能力（如 text_to_music）选择模型，并只使用该模型系列返回的控制项，例如 Suno 与 MiniMax 选项不可互换。

1. 使用参考音频：对于本地文件（如 FLAC、MP3、WAV），通过专用命令上传，返回可用作 reference_audio 的产物。说明应保留或改变的特征（如旋律、人声质感），用于指导生成，但结果需审听确认。

1. 生成与任务管理：提交 beatra.music.generate 请求前，确认制作卡并获取一次批准。生成后保留 task_id，通过 beatra.tasks.get 轮询，遵守 deadline_at；若未返回，则主动轮询 30 分钟后停止。任务列表搜索需匹配参数以避免重复付费。

1. 交付与审听：任务成功后，展示 task.output.clips 中的条目，提供 clip.audio.url、时长、MIME 类型等。审听内容包括作曲、人声表现、编曲等，但歌手身份、精确时长等仅为审听项，非保证属性。

适用边界与注意点

• 质量非保证：生成产物的歌手身份、发音、循环点等是事后审听质量，而非承诺属性。
• 付费确认：制作卡批准仅授权一次生成；任何参数修改（如提示词、标题、模型）需重新确认并创建新 client_request_id。
• 任务恢复：若任务失败或 ID 丢失，使用 beatra.tasks.list 搜索近期任务，仅参数完全相同才复用 ID，避免自动重试导致额外费用。
• 自动更新：客户端每 24 小时静默检查更新，失败不影响当前使用，但不作为重试理由。
• 模型限制：仅使用所选模型文档列出的控制项，参考音频用于指导而非绝对结果。