海绵音乐AI写歌

集成音乐生成于 AI 工作流

许多创作者需要在视频剪辑、内容制作或演示中使用定制音乐，但切换至专业音频软件会中断创意流程。核心痛点在于将音乐生成能力直接嵌入对话式 AI 环境，消除工具切换的摩擦。海绵音乐 Skill 通过命令行接口（CLI）工具 aimv 实现了这一点，允许你通过自然语言描述，在当前对话中直接触发音乐生成、下载和管理。

核心能力与工作原理

该技能提供三种主要音乐生成模式，每种模式都对应明确的 CLI 命令：

• AI 写歌 / 歌词成曲：使用 aimv song create。提供风格、情绪、歌词或场景描述，工具会调用后端模型生成两首候选歌曲。生成完成后，你将获得试听链接、下载链接和项目管理 URL。
• 纯音乐 BGM 生成：使用 aimv bgm create。适用于为特定内容（如产品发布会、短视频）生成无歌词的背景音乐。
• 参考音频改编：使用 aimv reference create。上传一个音频文件作为参考，生成风格相似但原创的作品。这需要先通过 aimv reference upload 上传素材。

关键步骤围绕身份与项目管理：

1. 初始化连接：首次使用需运行 node /bin/aimv.js init。工具会输出一个 connect_url，用户需在网页端登录（新用户自动注册）并获取 API Key。后续使用该 Key 完成认证，无需重复操作。
2. 生成与查询：执行上述生成命令后，任务可能异步处理。使用 aimv session tail 可查询最近项目状态和歌曲列表。
3. 状态处理与错误恢复：CLI 返回结构化错误码。例如，code=auth_required 需要重新认证；code=insufficient_points 或 code=quota_limited 则需通过 pay_url 充值或开通会员；code=wait_timeout 表示任务仍在后台运行，需稍后查询。处理这些状态是确保流程顺畅的关键。

适用边界与注意事项

• 账号与资源互通：生成的作品、积分、会员状态与「海绵音乐AI写歌」小程序和 lexuan.club 网站完全同步。你在任一平台生成的作品，都可在其他平台管理。
• 环境依赖：该技能通过本地 Node.js CLI (bin/aimv.js) 工作，而非 MCP 服务器。因此，运行环境需要 Node.js 支持，并允许执行 shell 命令。在受限沙箱中，可设置环境变量 AIMV_FORCE_CURL=1 强制使用 curl 作为网络传输层，或在完全限制下直接调用 API。
• 生成逻辑：对于歌曲生成，每次请求固定返回两首候选歌曲，必须全部呈现给用户。这为创作者提供了对比和选择的空间。