核心用法
Music Generator 是一款基于 Musicful 官方 API 的 AI 音乐生成技能，用户只需用自然语言描述需求，即可触发以下四种核心能力：
1. 完整歌曲生成：自动生成歌词并合成带人声音乐，支持自定义歌词输入
2. 纯背景音乐（BGM）：识别"纯音乐/背景音乐/伴奏"等语义，生成无歌词器乐
3. 仅生成歌词：快速产出符合主题的文本歌词，无音频合成
4. 任务状态查询：轮询追踪指定生成任务的实时进度
双阶段返回机制是该技能的显著特征：系统持续轮询任务状态，先返回 status=2 的预览音频链接供用户即时试听，待 status=0 后再推送最终可下载的完整 MP3 文件。默认同时生成两首变体，独立执行双阶段返回。
技术实现要点
- 入口指令：
/music_generator，通过mode参数分支控制（normal/bgm/lyrics） - 歌词流程：用户未提供歌词时，自动调用 V1 Lyrics API 生成 → 提交音乐合成 → 双阶段轮询
- 纯音乐流程：设置
instrumental: 1，跳过歌词环节，直接进入合成与轮询 - 强制配置检查：执行前必须从
<skill_root>/.env读取MUSICFUL_API_KEY，缺失则阻断并引导用户至官网获取密钥
显著优点
- 自然语言零门槛：无需学习专业音乐术语，"生成一首悲伤的摇滚"即可触发
- 智能意图识别：自动区分人声歌曲、纯音乐、仅歌词三种需求
- 实时反馈体验：预览链接机制让用户无需等待完整合成即可验证方向
- 灵活歌词模式：支持 AI 自动生成或用户完全自定义歌词
- 双版本输出：默认生成两首变体，提供更多选择空间
潜在缺点与局限性
- 外部依赖强耦合：完全依赖 Musicful 官方 API 可用性，服务中断则功能失效
- 无本地生成能力：所有计算在云端完成，需要稳定网络与有效 API 配额
- 轮询资源消耗：双阶段轮询对长时任务可能产生较多 API 调用
- 密钥管理门槛：要求用户自行配置
.env文件，技术小白可能遇到障碍 - 生成质量不可控：AI 对复杂风格描述的理解可能存在偏差，需多次尝试
适合人群
- 短视频创作者：快速获取匹配情绪的 BGM 或定制歌曲
- 独立音乐人：灵感辅助与 demo 快速生成
- 内容运营者：为品牌/活动定制主题曲
- 音乐爱好者：零基础体验 AI 作曲乐趣
- 开发者：需集成音乐生成能力的第三方应用
常规风险
- API 成本风险：Musicful 为付费服务，高频调用可能产生意外费用
- 版权归属模糊：生成音乐的商用版权需确认 Musicful 服务条款
- 预览与成品差异：预览阶段音频质量、时长可能与最终版本不同
- 任务失败处理：长时间轮询可能因服务端异常超时，需人工重试
- 密钥泄露风险：
.env文件若权限配置不当可能导致 API Key 暴露