参考音频改编AI

参考音频改编AI适合需要 reference music remix、参考音频改编、demo 改编和歌曲二创方向的创作者。你可以基于 demo、参考音频、已有歌曲或项目继续生成新版本，保留律动、情绪或风格方向，并获得新的歌曲候选；作品会同步到海绵音乐账号，可在「海绵音乐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=reference-music-remix&from=skill，把链接发给用户；用户网页登录（新用户自动注册）后复制 API Key 贴回对话，Agent 再运行 node <安装目录>/bin/aimv.js init --api-key <KEY> 完成连接。Key 长期有效，只需一次。

命名规范

展示名：参考音频改编AI
Skill slug / 目录名：reference-music-remix
Powered by：海绵音乐
Agent 工具名：aimv
工具底层配置：command: node + args: ["<安装目录>/bin/aimv.js"]

触发语义

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

参考音频改编
音乐改编
旋律参考
demo改编
参考音乐生成
AI改编歌曲
参考音频生成
续写歌曲
reference audio
music remix AI
song reference
AI remix

适用场景

基于 demo 生成新歌曲
延续参考音频的律动或情绪方向
改编已有生成歌曲或项目
创建可复用参考素材用于多次创作

典型用户说法

参考这段音频，保留律动但做成更明亮的流行歌
用这个 demo 做参考，让副歌更抓耳
延续上一个项目，但 hook 更强

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=reference-music-remix&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=reference-music-remix&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: reference-music-remix" -H "X-AIMV-Skill-Slug: reference-music-remix" \
  -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: reference-music-remix" -H "X-AIMV-Skill-Slug: reference-music-remix"
# → 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 环境变量替代本地配置。

参考音频改编AI

参考音频改编AI

本地 CLI 入口

命名规范

触发语义

适用场景

典型用户说法

Agent 调用原则

推荐命令

错误处理与用户引导

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