ACE-Step UI
🎬 演示
生成专业级 AI 音乐，搭配类 Spotify 的界面 —— 100% 免费 & 本地运行
🚀 为什么选择 ACE-Step UI？
还在为 Suno 或 Udio 每月 $10+ 付费？ ACE-Step 1.5 是一个开源版“平替甚至超越”方案，可在本地 GPU 上运行，而 ACE-Step UI 为其提供了专业级 UI 界面，让你充分释放其能力。
| 特性 | Suno/Udio | ACE-Step UI |
|---|---|---|
| 成本 | $10-50/月 | 永久免费 |
| 隐私 | 云端 | 100% 本地 |
| 所有权 | 授权使用 | 完全归你所有 |
| 可定制性 | 有限 | 完全控制 |
| 队列限制 | 有限制 | 无限制 |
| 商业使用 | 高价套餐 | 无任何限制 |
ACE-Step 1.5 的核心优势
- SOTA 音质，可对标商业产品
- 完整歌曲生成（最长 4+ 分钟，含人声）
- 完全离线运行
- 开源可控（可审计 / 修改 / 二次开发）
- 持续活跃更新
✨ 功能特性
🎵 AI 音乐生成
| 功能 | 描述 |
|---|---|
| 完整歌曲生成 | 支持生成包含歌词与人声的完整歌曲（最长 4+ 分钟） |
| 纯音乐模式 | 生成无人声的伴奏 |
| 自定义模式 | 自定义 BPM、调性、拍号、时长 |
| 风格标签 | 控制风格、情绪、节奏、乐器 |
| 批量生成 | 一次生成多个变体 |
| AI Enhance | 自动扩展风格标签（补充 BPM / 调性 / 拍号） |
| Thinking 模式 | AI 推理结构并生成音频编码 |
🎨 高级参数
| 功能 | 描述 |
|---|---|
| 参考音频 | 使用任意音频作为风格参考 |
| 音频重制（Cover） | 将已有音频转换为新风格 |
| 重绘（Repainting） | 局部重新生成 |
| Seed 控制 | 可复现生成结果 |
| 推理步数 | 控制质量与速度的权衡 |
🎤 歌词 & Prompt
| 功能 | 描述 |
|---|---|
| 歌词编辑器 | 支持结构标签（如 [Verse] / [Chorus]） |
| 格式助手 | AI 自动格式化歌词与描述 |
| Prompt 模板 | 内置风格模板 |
| 复用配置 | 复用历史生成参数 |
🎧 专业 UI
| 功能 | 描述 |
|---|---|
| 类 Spotify UI | 现代化设计，支持深色/浅色模式 |
| 底部播放器 | 波形 + 进度控制 |
| 音乐库管理 | 浏览 / 搜索 / 分类 |
| 收藏 & 播放列表 | 管理喜爱内容 |
| 实时进度 | 显示生成进度与队列 |
| 局域网访问 | 支持局域网多设备访问 |
🛠️ 内置工具
| 工具 | 描述 |
|---|---|
| 音频编辑器 | 裁剪、淡入淡出、特效 |
| 人声分离 | 分离人声 / 鼓 / 贝斯等 |
| 视频生成 | 自动生成音乐视频 |
| 封面生成 | 渐变风格专辑封面（无需联网） |
💻 技术栈
| 层级 | 技术 |
|---|---|
| 前端 | React 18 / TypeScript / TailwindCSS / Vite |
| 后端 | Express.js / SQLite |
| AI 引擎 | ACE-Step 1.5（Gradio API） |
| 音频工具 | AudioMass / Demucs / FFmpeg |
📋 环境要求
| 项目 | 要求 |
|---|---|
| Node.js | 18+ |
| Python | 3.10+（推荐 3.11） |
| GPU | ≥4GB（基础），推荐 ≥12GB（含 LLM） |
| CUDA | 12.8 |
| FFmpeg | 必需 |
| uv | 推荐 |
⚡ 快速开始
🎯 Pinokio 一键安装（推荐）
最简单方式，无需命令行：
👉 自动完成 Python / Node / 依赖 / 模型下载 / 启动
🪟 Windows 一键启动
cd ace-step-ui
start-all.bat
Linux / macOS 一键启动
cd ace-step-ui
./start-all.sh
📦 安装
1️⃣ 安装 ACE-Step（核心引擎）
Windows（推荐）
- 下载（约 5GB）
- 解压即可运行
- 内置 Python 环境
优势：
- 支持 4GB GPU
- 零配置
- 内置 CUDA
2️⃣ 安装 UI
git clone https://github.com/fspecii/ace-step-ui
cd ace-step-ui
./setup.sh
🎮 使用方法
Step 1：启动 ACE-Step
uv run acestep --port 8001 --enable-api
Step 2：启动 UI
./start.sh
Step 3：访问
- 本地：http://localhost:3000
- 局域网：http://YOUR_IP:3000
⚙️ 配置
PORT=3001
ACESTEP_API_URL=http://localhost:8001
DATABASE_PATH=./data/acestep.db
PEXELS_API_KEY=your_key_here
🎼 生成模式
简单模式
直接描述需求：
一首充满夏日氛围的流行歌曲
自定义模式
可控参数：
- 歌词
- 风格
- BPM
- 调性
- 时长
AI Enhance & Thinking
| 模式 | 说明 |
|---|---|
| OFF | 直接使用输入 |
| ON | 自动增强描述 |
| Thinking | 完整推理（最强） |
🔧 工具
- 音频编辑
- 人声分离
- 视频生成
- 封面生成
🐛 常见问题
| 问题 | 解决方案 |
|---|---|
| 无法连接 | 检查 API 是否开启 |
| 显存不足 | 使用 PT backend / 降低 batch |
| 风格不准 | 开启 AI Enhance |
| 时长 0:00 | 安装 FFmpeg |
🤝 贡献
欢迎参与：
- 提 Bug
- 提建议
- 提 PR
- 优化文档
流程：
git checkout -b feature/xxx
git commit -m "feat: xxx"
git push
📣 社区
关注获取：
- 教程
- 更新
- 技巧
- AI 音乐趋势
🙏 致谢
- ACE-Step
- AudioMass
- Demucs
- Pexels
📄 License
MIT License
⭐
如果这个项目帮你做出了不错的音乐，记得点个 Star ⭐
🎵
停止为 Suno 付费，开始用 ACE-Step 创作。
