> 核心功能: 本技能提供中文交互、化工作流场景等能力。

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 秒短视频,需要一段轻快的流行风格背景音乐。

scripts/generate.sh "upbeat pop song about summer vacation" \
  --duration 30 \
  --instrumental \
  --output summer_bgm.mp3

示例

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

scripts/generate.sh "gentle acoustic ballad, female vocal" \
  --lyrics "[Verse 1]\n阳光洒进窗台\n\n[Chorus]\n我们都是追梦人" \
  --duration 60 \
  --language zh \
  --output demo.mp3

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

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

scripts/generate.sh "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

第二步:执行生成命令

scripts/generate.sh "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+execute(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作,核心生成流程依赖外部API

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比