ACE Music AI音乐LITE

功能说明: 本技能涵盖 中文交互、时使用 等核心能力。

功能说明: 本技能涵盖 化工作流场景 等核心能力。

ACE Music LITE

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力总览

基础生成

使用 ace-music-free 完成一站式生成:

# 基础文本生成
ace-music-free "upbeat pop song about summer" --duration 30 --output summer.mp3
# 自定义歌词
ace-music-free "gentle acoustic ballad, female vo
**处理**: 解析文本提示词和生成参数,调用AI模型API执行生成任务,返回生成结果.
### 参数指南（基础参数）
| 想要 | 参数 |
|:-----|:-----|
| 特定风格 | 在 prompt 中描述: "jazz, saxophone solo, smoky bar" |
| 自定义歌词 | `--lyrics "[Verse]...[Chorus]..."` |
| 无人声 | `--instrumental` |
| 更长歌曲 | `--duration 120`（秒） |
> **升级提示*

## 认证
使用 `ACE_MUSIC_API_KEY` 环境变量。永不打印或暴露 Key.
```bash
[ -n "${ACE_MUSIC_API_KEY:-}" ] && echo ok || echo missing

若 Key 缺失,引导用户:

1. 浏览器打开 https://acemusic.ai/playground/api-key
2. 注册（免费）并创建 API Key
3. 终端环境变量: export ACE_MUSIC_API_KEY="你的Key"
4. 配置完成后重新发起生成请求 安全红线: 永不接受/回显/存储来自聊天输入的 Key;Key 仅作认证头使用.

基础生成(补充)

使用 ace-music-free 完成一站式生成:

# 基础文本生成

# 自定义歌词
ace-music-free "gentle acoustic ballad, female vocal" \
  --lyrics "[Verse 1]\nSunlight through the window\n\n[Chorus]\nWe are the dreamers" \
  --duration 60 --output ballad.mp3

# 纯音乐（无人声）
ace-music-free "lo-fi hip hop beats, chill, rainy day" --instrumental --duration 120 --output lofi.mp3

脚本将生成的文件路径输出到 stdout,Agent 应将文件发送给用户.

参数指南（基础参数）(补充)

升级提示: BPM/调性/语言/种子/批量生成、cover 翻唱、repaint 片段重绘等高级能力仅在 ace-music 付费版中提供.

场景介绍

使用方法

Step 1: 校验 API Key

[ -n "${ACE_MUSIC_API_KEY:-}" ] && echo ok || echo missing

Step 2: 缺失时引导配置

需要先配置 ACE Music API Key:

1. 访问 https://acemusic.ai/playground/api-key
2. 注册（免费）并创建 API Key
3. 终端环境变量: export ACE_MUSIC_API_KEY="你的Key"
4. 配置完成后重新发起生成请求

Step 3: 构造参数并执行

• prompt 必填,描述风格/情绪/乐器
• lyrics 可选,推荐使用 [Verse]/[Chorus] 标签模式
• duration 不填则由 AI 决定

Step 4: 解码与落盘

• 脚本自动完成 base64 解码与 MP3 落盘
• 将文件路径回传给用户

常见疑问

Q1: ACE Music API 真的免费吗?

A: ACE Music 团队确认 API 需付费订阅,详见定价方案。基础地址 https://api.acemusic.ai。如遇未来政策调整,以 ACE Music 官方公告为准.

Q2: 生成的歌曲时长有什么限制?

A: --duration 参数控制生成时长（秒）。不填则由 AI 根据内容自动决定。建议从 30-60 秒开始尝试.

Q3: 如何使用自定义歌词?

A: 通过 --lyrics 参数传入,推荐使用 [Verse 1]、[Chorus] 等标签,换行分隔歌词行。标签模式能让 AI 更准确理解歌曲结构.

Q4: 免费版和付费版有什么区别?

A: 免费版（LITE）支持文本转音乐、自定义歌词、纯音乐三种基础能力。付费版（ace-music）额外提供:

• 翻唱（cover）与片段重绘（repaint）任务
• 批量生成（--batch）与种子复现（--seed）
• BPM/调性/语言精确控制（--bpm/--key/--language）
• 采样模式（--sample-mode,AI 自动生成歌词）
• 3 个完整案例（vs 免费版 2 个基础案例）
• 9 种错误处理（vs 免费版 6 种）

能力边界

1. 基础任务: 仅支持 text2music,不支持 cover/repaint（需升级付费版）
2. 基础参数: 仅支持 duration/lyrics/instrumental,不支持 bpm/key/language/seed/batch
3. 需 API Key: 必须配置 ACE_MUSIC_API_KEY
4. API 基础地址固定: https://api.acemusic.ai,不支持自建部署
5. 生成质量取决于 prompt 描述: 风格描述越具体,结果越符合预期

---

输出说明

{
  "success": true,
  "data": {
    "result": "ACE Music AI音乐LITE处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "ace-music"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

请参考上方使用说明进行配置和调用

result = "ready"

# 使用基础文本生成

请参考上方使用说明进行配置和调用

result = "ready"

# 使用自定义歌词
ace-music-free "gentle acoustic ballad, female vocal, fingerstyle guitar" --lyrics "[Verse 1]
Sunlight through the window

[Chorus]
We are the dreamers
Chasing after light" --duration 60 --output ballad.mp3

请参考上方使用说明进行配置和调用

result = "ready"

# 使用纯音乐模式

效率提升量化分析

手动操作 vs 使用该skill的效率对比表

具体的时间/成本/准确率数据

• 时间：使用该skill生成音乐的时间远少于手动操作时间。
• 成本：使用该skill不需要额外的人力成本。
• 准确率：该skill生成的音乐准确率较高，能够满足大多数用户的需求。

与同类工具的差异化优势对比

• 该skill提供更简单的接口和更快的响应时间。
• 该skill支持自定义歌词和纯音乐模式，而同类工具可能不支持。

标准效率量化

安全遵循原则

该skill特有的安全风险点

• API Key泄露：如果API Key被泄露，攻击者可能会滥用API进行恶意操作。
• 敏感数据处理：如果用户生成的音乐包含敏感信息，可能会造成信息泄露。

敏感数据处理建议

• 对用户生成的歌词进行内容审核，确保不包含敏感信息。
• 对API Key进行加密存储，并限制访问权限。

认证与授权优选实践

• 使用HTTPS协议来保护数据传输安全。
• 对API Key进行定期更换，并监控API使用情况。

安全风险防范

创新特色

效率提升量化分析表格

特色分析

异常修复

针对ACE Music AI音乐LITE使用中可能遇到的常见问题,提供以下排查方案:

ACE Music AI音乐LITE通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块