核心功能: 本技能提供结构化的工作流程和配置指引等能力。

ACE音乐生成工具 - 免费版

概述

ACE音乐生成免费版是一款面向个人用户的AI音乐创作工具。通过自然语言描述即可生成包含人声、歌词的完整歌曲,无需乐理知识,几分钟即可获得原创音乐作品. 本版本依托 ACE-Step 1.5 模型能力,提供基础的文生音乐(text2music)功能,支持多种音乐风格与语言,适合短视频创作者、独立开发者及音乐爱好者快速产出音乐内容.

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：ACE、Step、模型免费生成带人、支持多语种、多风格、适合个人创作者快、速出曲、音乐生成免费版、面向个人内容创作、音乐生成工具、文本描述生成完整、含人声与歌词、支持流行、爵士等多种风格、提供中文、日文等多语种演唱、可调节时长、BPM、调式等基础参数等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一:短视频背景音乐

用户制作 30 秒短视频,需要一段轻快的流行风格背景音乐.

（请参考skill目录中的脚本文件） "upbeat pop song about summer vacation" \
  --duration 30 \
  --instrumental \
  --output summer_bgm.mp3

示例

音乐创作者希望快速将一段歌词转化为可听的人声 demo.

（请参考skill目录中的脚本文件） "gentle acoustic ballad, female vocal" \
  --lyrics "[Verse 1]\n阳光洒进窗台\n\n[Chorus]\n我们都是追梦人" \
  --duration 60 \
  --language zh \
  --output demo.mp3

场景三:学习/工作背景音

用户希望生成一段 lo-fi 助眠或专注背景音乐.

（请参考skill目录中的脚本文件） "lo-fi hip hop beats, chill, rainy night" \
  --instrumental \
  --duration 60 \
  --output lofi_focus.mp3

不适用场景

以下场景ACE音乐生成-免费版不适合处理：

• 版权受保护的媒体内容处理
• 实时直播推流
• 专业影视后期

触发条件

需要视频处理、音频编辑、媒体转换、配音生成时使用。不适用于非本工具能力范围的需求.

快速开始

领先步:配置 API Key

# 注册免费账号获取 Key
export ACE_MUSIC_API_KEY="${API_KEY:?请设置环境变量}"

获取地址:https://acemusic.ai/playground/api-key

第二步:执行生成命令

（请参考skill目录中的脚本文件） "rock anthem, energetic" \
  --bpm 140 \
  --key "E minor" \
  --output rock.mp3

第三步:获取结果

脚本将生成文件路径输出到 stdout,直接展示给用户即可.

配置示例

基础配置项说明:

# 环境变量
ACE_MUSIC_API_KEY=your_key         # 必填
ACE_MUSIC_BASE_URL=https://api.acemusic.ai  # 默认值
# ...
# 常用参数组合
# 纯音乐 + 长时长
--instrumental --duration 60
# ...
# 自定义歌词 + 指定语言
--lyrics "[Verse]...\n[Chorus]..." --language zh
# ...
# 固定随机种子(可复现)
--seed 42

优秀实践

1. 提示词要具体:描述风格、乐器、情绪,例如"jazz, saxophone solo, smoky bar, melancholic"
2. 歌词用结构标记:使用 [Verse]、[Chorus]、[Bridge] 分段,生成效果更佳
3. 时长选择:免费版建议 30-60 秒,过短可能不完整,过长受限于配额
4. 语言匹配:歌词为中文时务必加 --language zh,否则可能出现发音异常
5. 先试短后做长:先用 30 秒测试风格是否符合预期,再生成完整版本

常见问题

Q1:生成的音乐有杂音或人声不清晰?

A:尝试调整提示词,避免过多风格堆叠;确认网络稳定;如使用 --sample-mode,改为手动指定歌词模式.

已知限制

A:API 本身免费,但免费版单次时长限制为 60 秒,且不支持批量生成。如需更长时长或批量,请使用 PRO 版.

Q3:可以生成纯中文歌词的歌曲吗?

A:可以,使用 --language zh 参数,并在 --lyrics 中提供中文歌词即可.

Q4:生成的 MP3 文件保存在哪?

A:默认保存至当前工作目录,文件名由 --output 参数指定。如不指定,脚本自动生成随机文件名.

Q5:如何复现同一首歌曲?

A:使用相同的提示词、歌词和 --seed 参数值即可生成相似结果.

依赖说明

运行环境

• Agent平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 运行时: Bash shell + curl(脚本依赖)

依赖详情

API Key 配置

• 环境变量名: ACE_MUSIC_API_KEY
• 获取方式: 访问 https://acemusic.ai/playground/api-key 注册免费账号
• 存储建议: 写入 .env 文件或系统环境变量,避免硬编码到脚本

可用性分类

• 分类: MD+EXEC模式纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作,核心生成流程依赖外部API

错误处理

输出格式

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

边界条件与限制

输入限制

• 文本长度：输入描述的文本长度有限制，通常不超过500个字符，以确保生成过程的效率和准确性。
• 歌词结构：歌词中应避免使用特殊字符或符号，以免影响歌词解析和音乐生成。
• 语言支持：虽然支持多语种，但某些语言可能由于模型训练数据的原因，生成效果不如英语或其他主要语言。

性能边界

• 时长限制：免费版最长支持60秒的音乐时长，超过此时长将无法生成。
• 并发限制：同一时间只能处理一个音乐生成请求，无法同时处理多个请求。

兼容性约束

• 操作系统：虽然理论上支持Windows、macOS和Linux，但某些特定功能可能在不同操作系统上表现不同。
• 网络环境：需要稳定的网络连接，否则可能导致生成失败或响应时间延长。
• API Key：API Key的有效性受限于服务提供商，过期或被禁用将导致无法使用该技能。

其他限制

• 版权问题：生成的音乐可能包含版权内容，用户需自行确保其使用不侵犯他人版权。
• 隐私保护：用户上传的歌词或描述信息将被用于音乐生成，但服务提供商承诺不会用于其他目的。