> 核心功能: 本技能提供中文交互、时使用等能力。

> 核心功能: 本技能提供时长参数控制等能力。

ACE Music LITE

ACE Music 基础版,基于 ACE-Step 1.5 模型生成 AI 音乐。付费订阅使用。仅支持文本转音乐（text2music）任务.
范围外（本技能不做）: 翻唱（cover）、片段重绘（repaint）、批量生成、种子复现、BPM/调性精确控制（需升级付费版）.

运行环境

运行环境

• 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 应将文件发送给用户.

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

[ -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 落盘
• 将文件路径回传给用户

错误恢复策略

输出说明

{
  "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基础版,文本转音乐生成,支持歌词定制和纯音乐模式。ACE Music AI 音乐生成基础客户端（免费版
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

特色分析

异常修复

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

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

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

错误恢复方案

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

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent
• 操作系统: Windows / macOS / Linux

可用性分类

• 分类: MD（纯Markdown指令，通过自然语言驱动Agent完成操作）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作。

```