AI歌曲

解决的问题

对于需要快速原型化或定制化音频内容的开发者而言，从零开始创作一首完整歌曲涉及作词、谱曲、编曲、录制等多道复杂工序，且依赖专业软件与音频工程知识。这个过程耗时且门槛较高。本技能旨在通过 AI 模型将这一流程封装为可程序化调用的命令行工具，使开发者能够通过文本描述（如主题、情绪、风格、歌词）直接生成可试听、可下载的完整歌曲音频及项目文件，显著缩短从创意到成品的路径。

核心工作流与能力

本技能的核心是 aimv 命令行工具，它作为与后端 AI 生成服务和 海绵音乐 平台交互的统一入口。工作流围绕几个关键步骤：

1. 身份验证：首次使用需通过 aimv init 命令与 海绵音乐 账号绑定。工具会生成一个专用连接页链接，用户登录后获取 API Key 完成鉴权。此后所有操作均通过该 API Key 进行身份验证。
2. 歌曲生成：这是核心能力。开发者调用 aimv song create 命令，并传入文本提示（例如 --prompt "主题是夏天旅行的轻快流行歌"）。AI 模型将根据提示生成完整的歌曲音频（通常包含两个候选版本）、歌词和元数据。生成过程在云端异步进行。
3. 状态查询与管理：生成任务可能需时，可通过 aimv session list 或 aimv song status 查询项目状态和结果。所有生成的作品会同步至 海绵音乐 平台，可通过配套的微信小程序或 lexuan.club 网页端进行后续的播放、管理和下载。
4. 错误处理：工具提供了结构化的错误码。例如，遇到 code=auth_required 会返回登录链接；code=insufficient_points 返回充值链接。这使得 Agent 可以自动解析错误并引导用户完成下一步操作（如登录或付费），而非简单报错。

边界与注意事项

• 环境依赖：技能运行依赖于网络连接。在某些受限的 Agent 沙箱环境中，如果 aimv 命令因网络限制失败，可尝试设置环境变量 AIMV_FORCE_CURL=1 让工具改用系统 curl。若 aimv 完全不可用，则需回退到直接使用 curl 调用其 REST API。
• 付费模型与配额：生成歌曲消耗 海绵音乐 平台的积分或会员额度。当遇到 code=insufficient_points (402) 或 code=quota_limited (429) 时，需要引导用户访问返回的 pay_url 进行充值或开通会员。这是一个需要用户参与的付费环节。
• 内容依赖：生成效果严重依赖于 AI 模型的能力和用户提供的文本提示质量。生成的歌曲在版权、原创性等方面可能存在模糊地带，且风格和完成度可能无法满足所有专业需求，更适合用于快速探索、小样制作或短视频配乐等场景。