SunoAI-AI作曲（文生音乐、图生音乐）

概述

Suno.cn AI 作曲

使用随包提供的命令行 helper 根据创作描述或歌词生成歌曲、纯音乐、BGM 和配乐。首次使用通过网页授权；生成任务可能消耗账户积分。

何时使用

适用于：

• 根据主题、场景、情绪、曲风或乐器编制生成歌曲。
• 根据用户提供的完整歌词生成歌曲。
• 生成纯音乐、短视频配乐、游戏 BGM 或播客片头音乐。

不用于单独写歌词、续写已有歌曲、参考音频翻唱或改编、人声分离和其他音频处理。不要承诺生成效果、版权归属或商用权利。

核心规则

1. 所有网络请求只能通过 node scripts/suno-client.mjs ... 发起。不得使用 curl、浏览器脚本、自行拼接 HTTP 请求或 MCP JSON-RPC。
2. 不读取、打印、复述或记录 Skill Key、网站 Token、SUNO_CN_API_KEY 或凭证文件内容。
3. 提交前按需读取 [生成歌曲契约](references/song-generation.md)，只使用已声明的模型、字段和约束。
4. 用户明确要求执行前，先核对歌曲名称、创作描述或歌词、音乐风格、是否纯音乐以及时长等已提供关键参数。用户未指定的可选参数使用接口默认值，不自行补写歌词或风格。
5. 生成任务可能消耗积分。积分不足或请求结果未知时不得静默重试，必须按本文的恢复流程处理。

执行流程

1. 确认请求属于新歌曲、纯音乐、BGM 或配乐生成，并已给出可作为 prompt 的创作描述或歌词。
2. 首次业务请求前执行 auth status。未授权时执行 auth start，把返回的原始 action.url 同时作为可点击 Markdown 链接和可复制代码块交给用户，等待其确认网页授权完成后执行 auth complete。
3. 根据 [生成歌曲契约](references/song-generation.md) 组装 POST /mcp/api/generate 的 JSON 请求。用户提供完整歌词或指定时长时使用自定义模式；纯音乐必须明确设置为纯音乐。
4. 执行提交命令。返回 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/generate '{"prompt":"温暖的民谣，木吉他和女声","mv":"chirp-hawk"}'
node scripts/suno-client.mjs request POST /mcp/api/generate '{"prompt":"[Verse] 城市的雨落在窗前","title":"雨夜","tags":"流行抒情","custom_mode":true}'
node scripts/suno-client.mjs request POST /mcp/api/generate '{"prompt":"适合旅行视频的轻快木吉他配乐","instrumental":true}'
node scripts/suno-client.mjs request GET '/mcp/api/task/任务编号?wait=45'

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