SunoAI-AI生歌词

概述

Suno.cn AI 写歌词

使用随包提供的命令行 helper 根据灵感或标题生成完整歌词。首次使用通过网页授权；积分和可用性以服务端返回为准。

何时使用

适用于：

• 根据主题、人物、场景、情绪或故事写一首歌的歌词。
• 根据歌曲名称生成歌词。
• 在明确曲风要求下生成相应风格的歌词。

不用于生成音频、续写已有歌曲、读取已有歌曲歌词、翻唱或音频处理。用户只提出“写歌词”但未给出标题或灵感时，必须先询问，不自行虚构主题。

核心规则

1. 所有网络请求只能通过 node scripts/suno-client.mjs ... 发起。不得使用 curl、浏览器脚本、自行拼接 HTTP 请求或 MCP JSON-RPC。
2. 不读取、打印、复述或记录 Skill Key、网站 Token、SUNO_CN_API_KEY 或凭证文件内容。
3. 提交前按需读取 [歌词生成契约](references/lyrics-generation.md)，只使用已声明字段和约束。
4. inspiration 与 title 至少提供一项；style 仅在用户明确提出曲风或表达方式时传入。不要自行添加未请求的标题、曲风或歌词结构。
5. 在用户明确要求生成前，复述已提供的标题、灵感和曲风。服务端返回歌词后直接交付；不要把歌词生成说成歌曲生成完成。
6. 返回积分不足、授权失效或请求结果未知时，严格执行共享 helper 的恢复流程，不得静默重试。

执行流程

1. 收集标题或灵感；若两者均缺失，询问用户想写什么主题或歌曲名称。
2. 首次业务请求前执行 auth status。未授权时执行 auth start，把返回的原始 action.url 同时作为可点击 Markdown 链接和可复制代码块交给用户，等待其确认网页授权完成后执行 auth complete。
3. 调用 POST /mcp/api/gen-lyrics。该接口会等待流式歌词完整汇总后返回，不需要任务轮询。
4. 交付返回的 lyrics。若服务端返回失败原因，使用该原因提示用户，不泄露内部字段或运行时错误。

授权、积分与恢复

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/gen-lyrics '{"inspiration":"秋夜重逢","style":"温暖民谣"}'
node scripts/suno-client.mjs request POST /mcp/api/gen-lyrics '{"title":"雨夜","style":"流行抒情"}'

完整字段与错误处理见 [歌词生成契约](references/lyrics-generation.md)。