SunoAI-AI续写歌曲

概述

Suno.cn 歌曲续写

使用随包提供的命令行 helper 从已有歌曲的结尾或用户指定时间点继续生成后续音乐。首次使用通过网页授权；续写任务可能消耗账户积分。

何时使用

适用于：

• 续写已有歌曲的后半段或下一段音乐。
• 延长已生成歌曲。
• 从歌曲中的指定秒数继续创作。

不用于从零生成新歌、改写歌词、参考音频翻唱或改编、添加人声/伴奏/音轨，以及其他音频处理。续写接口不会接收新的标题、风格或歌词，不要承诺修改原曲这些内容。

核心规则

1. 所有网络请求只能通过 node scripts/suno-client.mjs ... 发起。不得使用 curl、浏览器脚本、自行拼接 HTTP 请求或 MCP JSON-RPC。
2. 不读取、打印、复述或记录 Skill Key、网站 Token、SUNO_CN_API_KEY 或凭证文件内容。
3. 提交前按需读取 [歌曲续写契约](references/song-continuation.md)，只使用已声明的模型、字段和约束。
4. 必须确认原歌曲。用户给出 serial_no 时直接使用；用户只说“上一首”或“那首歌”时，可查询最近作品辅助定位。存在多个候选或无法确定时，要求用户明确选择，不猜测。
5. 用户未指定续写起点时传 continue_at: 0，由后端从歌曲末尾续写；指定“从第 N 秒继续”时，使用对应的非负整数秒数。
6. 续写任务可能消耗积分。积分不足或请求结果未知时不得静默重试，必须按本文的恢复流程处理。

执行流程

1. 确认原歌曲任务编号、续写起点和用户明确的模型选择。模型未指定时使用默认 V6。
2. 首次业务请求前执行 auth status。未授权时执行 auth start，把返回的原始 action.url 同时作为可点击 Markdown 链接和可复制代码块交给用户，等待其确认网页授权完成后执行 auth complete。
3. 续写目标不明确时调用 GET /mcp/api/music?page=1&page_size=10 获取候选；仅在用户明确指定后继续。
4. 提交前复述原歌曲、续写位置和模型。调用 POST /mcp/api/extend 后，serial_nos 仅表示续写任务已提交，不表示歌曲已经完成。
5. 使用新任务编号查询状态，成功时交付播放链接；失败时只说明服务端返回的业务原因。

授权、积分与恢复

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 request POST /mcp/api/extend '{"serial_no":"原歌曲任务编号","continue_at":0,"mv":"chirp-hawk"}'
node scripts/suno-client.mjs request POST /mcp/api/extend '{"serial_no":"原歌曲任务编号","continue_at":80,"mv":"v6-wild"}'
node scripts/suno-client.mjs request GET '/mcp/api/task/新任务编号?wait=45'

完整字段、模型、任务状态和错误处理见 [歌曲续写契约](references/song-continuation.md)。