SunoAI-AI添加音轨

概述

Suno.cn 参考音频添加音轨

使用随包提供的命令行 helper 上传参考 MP3，等待服务端准备成功后按用户指定的音轨描述生成新版本。首次使用通过网页授权；准备和生成音轨任务的积分与可用性以服务端返回为准。

何时使用

适用于：

• 为参考音乐添加吉他、鼓、贝斯、弦乐或其他明确的乐器音轨。
• 根据用户提供的参考音频和音轨描述生成带新增音轨的版本。

不用于人声/伴奏添加、翻唱、续写已有站内歌曲、分离已有音轨，或普通音频处理。只支持本地 MP3，不要将 MP4、WAV 或在线音频链接伪装成参考文件。

核心规则

1. 所有网络请求只能通过 node scripts/suno-client.mjs ... 发起。不得使用 curl、浏览器脚本、自行拼接 HTTP 请求或 MCP JSON-RPC。
2. 不读取、打印、复述或记录 Skill Key、网站 Token、SUNO_CN_API_KEY 或凭证文件内容。
3. 提交前按需读取 [添加音轨契约](references/reference-audio-stem.md)，只使用已声明字段和约束。
4. 仅接受 10-240 秒、最大 50 MiB 的本地 MP3。上传使用固定 add_stem 操作；上传已提交不等于参考音频准备完成。
5. 必须收集 stem_control_tags：用户明确要添加的音轨类型或描述，例如“带失真的电吉他节奏轨”“轻柔爵士鼓”“低音提琴与大提琴层”。不得自行猜测要添加什么音轨。
6. 只有参考音频准备状态成功后，才能用成功结果中的参考任务编号提交添加音轨。准备中、失败或多个音频候选未明确选择时，禁止继续。
7. 在用户明确要求执行前，确认参考文件、音轨描述、歌曲名称、音乐风格和模型。收费任务不得静默重试。

执行流程

1. 确认用户已经明确选择一个本地 MP3 和要添加的音轨描述；任一项缺失时先询问。多个候选文件时要求用户明确指定，不猜测。
2. 首次业务请求前执行 auth status。未授权时执行 auth start，把返回的原始 action.url 同时作为可点击 Markdown 链接和可复制代码块交给用户，等待其确认网页授权完成后执行 auth complete。
3. 执行 upload-reference <file> add_stem [title]，取得上传准备任务编号。
4. 调用 GET /mcp/api/upload/<serial_no>?wait=45 查询准备状态。仅在状态成功后，读取其参考任务编号作为 continue_serial_no。
5. 复述实际提交参数后，调用 POST /mcp/api/generate，传入 reference_operation: "add_stem"、continue_serial_no、continue_at: 0 和 stem_control_tags。普通 prompt 不作为该任务的必填输入。
6. 使用新歌曲任务编号查询状态，成功时交付播放链接；失败时只说明服务端返回的业务原因。

授权、积分与恢复

node scripts/suno-client.mjs auth status
node scripts/suno-client.mjs auth start
node scripts/suno-client.mjs auth complete
node scripts/suno-client.mjs purchase status

• action.url 中的 code 是一次性授权请求定位码，不是 Skill Key、网站 Token 或密码。不得加密、哈希、脱敏、截断、二次编码、重组、替换或删除该链接；不得自行拼接链接。
• 授权完成前不提交上传或添加音轨任务。用户要求撤销授权时执行 auth logout，不要手工删除凭证。
• 返回 insufficient_credits 时，原样交付 action.url。用户购买完成后先执行 purchase status，再次取得用户明确确认后才执行 helper 返回的 purchase retry <operation_id>；最多提交一次。
• 返回 result_unknown 或 operation_state_unknown 时，先查询参考准备任务和歌曲任务，禁止直接重试。

常用命令

node scripts/suno-client.mjs upload-reference ./reference.mp3 add_stem "参考音乐"
node scripts/suno-client.mjs request GET '/mcp/api/upload/参考准备任务编号?wait=45'
node scripts/suno-client.mjs request POST /mcp/api/generate '{"title":"新增音轨版本","tags":"摇滚","mv":"v6","reference_operation":"add_stem","continue_serial_no":"准备成功后的参考任务编号","continue_at":0,"stem_control_tags":"带失真的电吉他节奏轨和有力的摇滚鼓组"}'
node scripts/suno-client.mjs request GET '/mcp/api/task/新歌曲任务编号?wait=45'

完整字段、文件限制、状态和错误处理见 [添加音轨契约](references/reference-audio-stem.md)。