AI背景音乐生成

要解决的具体问题

在内容创作流程中，背景音乐（BGM）是提升视频、游戏或播客沉浸感的关键元素。传统 BGM 获取方式存在明显瓶颈：音乐库搜索耗时且版权风险高，定制作曲需要专业技能或外部协作，而现有 AI 生成工具往往操作独立，难以集成到自动化开发或 Agent 工作流中。这导致创作者在批量生产内容时，音乐生成环节成为效率瓶颈，尤其对技术背景的独立开发者或小型团队而言。

技能如何工作

本技能通过 aimv 命令行工具（CLI）提供 AI 背景音乐生成能力，核心是调用海绵音乐的云端 AI 模型，将文本描述转化为纯音乐轨道。其工作原理围绕三个关键步骤：

1. 初始化与认证：首次使用需运行 node /bin/aimv.js init，CLI 输出登录页面链接（如 https://lexuan.club/skills/connect?slug=bgm-maker&from=skill）。用户完成网页登录后，复制 API Key 并运行 init --api-key <key> 完成连接。该 Key 长期有效，实现与海绵音乐账号的同步。
2. 音乐生成：通过命令如 aimv bgm create 或直接执行 shell 命令，输入结构化描述（例如“城市夜景 vlog 的轻电子 BGM”）。AI 会生成两首候选曲目，支持上传参考音频进行风格引导。生成过程异步，CLI 提供状态查询（aimv session tail）和错误处理（如 wait_timeout 表示后台生成中）。
3. 结果管理与下载：生成完成后，作品自动同步到海绵音乐账号，可通过 CLI 下载音频文件，或在小程序 海绵音乐AI写歌 和网页 lexuan.club 进一步编辑。错误标签（如 insufficient_points）直接引导用户到充值页面，实现闭环操作。

技能设计强调与开发环境的深度集成：当 Agent 具备 shell 执行权限时，全流程可通过 CLI 自动化；在受限沙箱中，可设置环境变量 AIMV_FORCE_CURL=1 强制使用 curl 作为传输层，或直接调用 REST API。这种灵活性使其适合嵌入 CI/CD 流程或批量处理脚本。

适用边界与注意点

• 环境依赖：生成依赖海绵音乐云服务，需要稳定网络；本地 CLI 需要 Node.js 运行时，且配置目录可通过 AIMV_CONFIG_DIR 环境变量重定向。
• 额度与权限：免费额度有限，超出后 API 返回 code=402 需充值；会员提升额度。API Key 需妥善保管，避免泄露。
• 生成限制：输出为纯音乐 BGM，适合短时循环曲目；不支持人声合成或复杂编曲。描述质量直接影响结果，需具体指定情绪（如“平静”）、节奏（如“中等速度”）和乐器（如“钢琴”）。
• 工作流边界：技能专注于音乐生成，不处理视频剪辑或内容集成；生成结果需用户自行管理版权，尤其对于商业用途。

该工具将 AI 音乐生成转化为可编程接口，适用于技术创作者快速原型开发、内容农场批量配乐或多媒体项目自动化，但需注意其服务化特性和输出粒度。