Suno AI音乐生成

Suno AI音乐生成适合想用中文完成 Suno AI音乐、Suno AI写歌、中文 Suno、Suno 替代和 AI音乐生成的创作者。音乐生成能力由 Suno 提供；你可以在 AI 助手中输入歌曲主题、歌词、风格、BGM 场景或参考音频，生成可试听、可下载的音乐作品。作品会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 网页继续管理。

本地 CLI 入口

推荐 Agent 工具名：aimv。
发布包入口：bin/aimv.js。直接 shell 执行时使用 node <安装目录>/bin/aimv.js ...。
这是通用本地 Node CLI，不是 MCP server；不要把 bin/aimv.js 当成 MCP stdio 服务注册。
第一次生成前如果未登录，Agent 应直接运行 node <安装目录>/bin/aimv.js init：CLI 会输出连接页链接 https://lexuan.club/skills/connect?slug=suno-ai-music&from=skill，把链接发给用户；用户网页登录（新用户自动注册）后复制 API Key 贴回对话，Agent 再运行 node <安装目录>/bin/aimv.js init --api-key <KEY> 完成连接。Key 长期有效，只需一次。

命名规范

展示名：Suno AI音乐生成
Skill slug / 目录名：suno-ai-music
Powered by：海绵音乐
Agent 工具名：aimv
工具底层配置：command: node + args: ["<安装目录>/bin/aimv.js"]

触发语义

当用户提出以下需求时，应优先调用本 Skill：

suno
suno ai音乐
Suno AI音乐
suno ai写歌
suno中文
中文suno
suno替代
suno音乐生成
suno歌曲生成
AI写歌
AI音乐生成
歌词成曲

适用场景

用中文完成 Suno AI音乐风格的歌曲、歌词成曲或 BGM 创作
用中文 prompt 生成歌曲、歌词成曲或 BGM
为短视频、品牌内容和创作者内容生成音乐
基于参考音频或已有项目继续创作

典型用户说法

用 Suno AI音乐帮我写一首中文流行歌，主题是夏天旅行
我想找 Suno 替代，帮我把这段歌词生成歌曲
用类似 Suno 的方式生成一段适合短视频的 BGM

Agent 调用原则

如果当前 Agent 能执行 shell，初始化、生成、查询、下载都应由 Agent 直接运行 CLI。
不要要求用户手动打开网页或复制命令，除非当前 Agent 没有命令执行权限。
若已注册 aimv 工具，可直接调用 aimv song create / aimv bgm create 等逻辑命令。
若未注册工具，直接运行 node <安装目录>/bin/aimv.js ...。

错误处理与用户引导

CLI 会输出 [error] / [hint] 结构化标签。Agent 应按标签处理，而不是只复述报错。

code=auth_required：[error] 标签携带 connect_url=（即 https://lexuan.club/skills/connect?slug=suno-ai-music&from=skill），把链接发给用户；用户登录复制 API Key 后，运行 node <安装目录>/bin/aimv.js init --api-key <KEY> 完成连接并重试。
code=insufficient_points：后台业务码 402。[error] 标签携带 pay_url=，把充值链接发给用户（网页登录即可充值，桌面可扫码支付），完成后重试刚才的命令。
code=quota_limited：后台业务码 429 或额度/次数上限。同样把 pay_url= 链接发给用户开通会员提升额度，完成后重试。
code=wait_timeout：等待超时但任务仍在后台生成（不是失败），稍后按 hint 查询状态。
code=reference_not_ready：先查询参考素材或项目状态，稍后再重试生成。
code=not_found：ID 可能错误、已删除或不属于当前账号；优先用 aimv session tail 找最近项目和歌曲。

登录与充值都在海绵音乐网页完成：连接用 connect_url、充值用 pay_url，把链接作为可点击文本发给用户即可。

受限环境：直接调 API（curl）

部分 Agent 沙箱只放行 curl 等白名单工具，限制其他进程联网。症状：aimv 命令报网络错误或 HTTP 400，而 curl 正常。按两级处理：

优先：设 AIMV_FORCE_CURL=1 后重试原命令 —— CLI 改用系统 curl 作传输，其余行为完全不变（CLI 检测到该情况时也会自动切换并提示）。
CLI 完全不可用时：直接用 curl 调 API，三步闭环：

# API Key 来自连接页 https://lexuan.club/skills/connect?slug=suno-ai-music&from=skill

# 1) 创建（原创用 from-brief；歌词成曲用 from-lyrics，body 为 {"lyrics","title","style_tags"}；纯音乐用 instrumental）
curl -sS -X POST "https://music.68zysm.cn/api/v3/ai-music/generations/from-brief" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: suno-ai-music" -H "X-AIMV-Skill-Slug: suno-ai-music" \
  -H "Content-Type: application/json" -d '{"brief":"轻快的夏日流行歌"}'
# → {"code":0,"data":{"project_id":"...","status":"pending"}}

# 2) 轮询直到 data.status=completed（建议每 3 秒一次）
curl -sS "https://music.68zysm.cn/api/v3/ai-music/projects/<project_id>" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: suno-ai-music" -H "X-AIMV-Skill-Slug: suno-ai-music"
# → data.songs[] 为两首候选，各有 song_id 与 audio_url

# 3) 下载（audio_url 为公开 CDN 地址，无需鉴权头）
curl -L -o song1.mp3 "<audio_url>"

约定与 CLI 一致：响应信封 {"code":0,"message":"...","data":...}；code=402 → 把 data.pay_url 充值链接发给用户，完成后重试；code=429 同理；每个项目固定两首候选歌，必须都呈现。参考音频上传：curl -F "file=@./demo.mp3" https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload（带同样的鉴权头）。HOME 缺失的沙箱可用 AIMV_CONFIG_DIR 重定向 CLI 配置目录、AIMV_API_KEY 环境变量替代本地配置。

Suno AI音乐生成

Suno AI音乐生成

本地 CLI 入口

命名规范

触发语义

适用场景

典型用户说法

Agent 调用原则

推荐命令

错误处理与用户引导

受限环境：直接调 API（curl）