Suno AI音乐

解决的问题

许多音乐创作者在尝试用中文生成歌曲、歌词成曲或背景音乐（BGM）时，常遇到工具集成复杂、语言支持不足或管理分散的问题。例如，使用 Suno AI 等国际服务可能缺乏直接的中文 prompt 优化，导致生成效果不佳；或者生成后的音频文件难以统一管理，影响在短视频、品牌内容等场景的应用。具体痛点包括：如何快速将中文主题转化为可试听的音乐，以及如何高效处理生成过程中的错误和账号同步。

工作原理与核心能力

该技能通过本地 CLI 工具 aimv 封装 Suno AI 的音乐生成能力，提供以下核心功能：

• 中文 Prompt 与生成支持：允许用户输入中文歌曲主题、歌词、风格或参考音频，直接生成音乐作品。生成能力由 Suno 提供，但针对中文场景进行了优化。
• 关键步骤：

1. 初始化连接：首次使用时，运行 node /bin/aimv.js init；CLI 输出连接链接（如 https://lexuan.club/skills/connect?slug=suno-ai-pro）。用户登录海绵音乐网页后，复制 API Key 贴回，执行 init --api-key 完成连接。API Key 长期有效，只需一次操作。
2. 音乐生成：使用命令如 aimv song create 或 aimv bgm create，通过参数指定 --theme、--lyrics、--style 等；也可以直接运行 node /bin/aimv.js 后接相应参数。生成的作品会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序或 lexuan.club 网页管理。
3. 错误处理：CLI 输出结构化标签，如 [error] 和 [hint]。Agent 应按标签处理，例如 code=auth_required 时引导用户登录获取 API Key，code=insufficient_points 时提供充值链接。

工具底层通过 API 交互，响应采用 { "code": 0, "data": ... } 格式；在受限环境中，可设置 AIMV_FORCE_CURL=1 强制使用系统 curl 传输。

适用边界与注意点

• 环境限制：在 Agent 沙箱中，如果 CLI 报网络错误，优先尝试设置 AIMV_FORCE_CURL=1；若 CLI 完全不可用，可通过 curl 直接调用 API，但需处理鉴权头和响应解析。
• 生成规则：每个项目默认生成两首候选歌曲，必须全部呈现给用户；参考音频上传需使用指定端点（如 https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload）。
• 账号与积分：技能与海绵音乐账号互通，生成前需确保已连接且积分充足；错误码 402 或 429 时，引导用户通过 pay_url 充值或开通会员。
• 适用场景：适合中文歌曲创作、BGM 生成，但不要求用户手动操作网页，除非 Agent 无命令执行权限。不适用于非音乐生成任务。