AI音乐

具体问题

音乐创作通常需要专业技能和时间投入，尤其对于短视频、播客或广告等快速迭代的内容场景，创作者往往需要定制化但高效的音乐解决方案。传统方式依赖人工作曲或素材库搜索，难以平衡原创性与速度。AI 音乐生成工具通过自然语言描述自动化这一过程，但实现时面临 API 认证、命令行集成和错误恢复等技术挑战，需要开发者处理底层细节以确保可靠使用。

技能如何工作

该技能基于海绵音乐的 AI 服务，提供命令行接口（CLI）工具 aimv，支持通过描述生成歌曲和 BGM。核心能力包括：

• 生成定制音乐：用户输入主题、风格、情绪或歌词等描述，CLI 调用 API 生成可试听的音频作品，支持歌曲和背景音乐两种类型。
• 管理作品与账号：生成的作品自动同步到海绵音乐账号，可与小程序或网页端（lexuan.club）互通，方便后续编辑和下载。
• 自动化工作流：Agent 可直接执行 shell 命令，如 node /bin/aimv.js init 初始化连接、aimv song create 生成歌曲，实现端到端操作。

关键步骤包括：

1. 初始化认证：首次使用时，运行 node /bin/aimv.js init 获取连接链接，用户登录后提供 API Key 完成绑定（仅需一次）。
2. 生成音乐：根据需求执行生成命令，CLI 返回结构化响应，Agent 处理状态并引导用户试听或下载。
3. 错误处理与恢复：CLI 输出带标签的错误信息，如 [error] 或 [hint]，Agent 需根据代码（如 auth_required、insufficient_points）采取对应行动，例如发送登录或充值链接。

在受限环境中（如沙箱），可设置 AIMV_FORCE_CURL=1 环境变量让 CLI 改用系统 curl 作为传输层，确保网络可用；极端情况下也可直接使用 curl 调用 API，遵循相同响应信封格式（如 code、data 字段）。

适用边界与注意点

• 依赖外部服务：生成过程完全依赖海绵音乐 API，需稳定网络连接；积分和会员体系影响使用额度，额度不足时需通过充值链接处理。
• 语言与场景限制：主要针对中文音乐生成优化，英文或其他语言支持有限；适合创意快速原型，但专业级制作可能仍需人工调整。
• 安全与配置：API Key 长期有效，应避免泄露；配置目录可通过 AIMV_CONFIG_DIR 重定向，适应不同环境。
• 错误恢复机制：Agent 必须解析 CLI 的结构化标签（如 code=quota_limited），而非直接报错，以提供准确的用户引导。
• 作品管理：生成后每个项目默认两首候选歌，都需呈现给用户；参考音频上传支持，但需通过特定 API 端点。