ACE-Step UI

终极开源 Suno 替代方案
与 ACE-Step 1.5 无缝集成 - 开源 AI 音乐生成模型

演示 • 为什么选择 ACE-Step • 功能特性 • 安装说明 • 使用方法 • 参与贡献

## 🎬 演示

通过类似 Spotify 的界面生成专业的 AI 音乐 - 100% 免费且本地运行

## 🚀 为什么选择 ACE-Step UI？ **厌倦了为 Suno 或 Udio 每月支付 10 美元以上的费用？** ACE-Step 1.5 是**开源的 Suno 杀手**，可在您自己的 GPU 上本地运行 - 而 ACE-Step UI 为您提供了一个**美观、专业的界面**，以充分发挥其强大功能。 | 特性 | Suno/Udio | ACE-Step UI | |---------|-----------|-------------| | **费用** | $10-50/月 | **永久免费** | | **隐私** | 基于云端 | **100% 本地** | | **所有权** | 授权许可 | **一切归您所有** | | **自定义** | 有限 | **完全控制** | | **排队限制** | 受限 | **无限制** | | **商业用途** | 昂贵的高级版 | **无限制** | ### 是什么让 ACE-Step 1.5 如此特别？ - **媲美商业服务的最先进质量** - **支持人声的完整歌曲生成**，时长可达 4 分钟以上 - **本地运行** - 初始设置后无需联网 - **开源** - 可检查、修改和改进 - **活跃开发** - 持续不断改进 ## ✨ 功能特性 ### 🎵 AI 音乐生成 | 特性 | 描述 | |---------|-------------| | **完整歌曲生成** | 创作带有 vocals 和歌词的完整歌曲，时长可达 4 分钟以上 | | **纯音乐模式** | 生成不带人声的伴奏音轨 | | **自定义模式** | 微调 BPM、调性、拍号和时长 | | **风格标签** | 定义流派、情绪、速度和乐器编排 | | **批量生成** | 一次生成多个不同版本 | | **AI 增强** | 将流派标签丰富为带有正确 BPM/调性/拍号的详细提示词 | | **思考模式** | 让 AI 推理歌曲结构并生成音频代码 | ### 🎨 高级参数 | 特性 | 描述 | |---------|-------------| | **参考音频** | 使用任意音频文件作为风格参考 | | **音频翻唱** | 用新风格转换现有音频 | | **局部重绘** | 重新生成音轨的特定片段 | | **种子控制** | 复现完全一致的生成结果 | | **推理步数** | 控制质量与速度的平衡 | ### 🎤 歌词与提示词 | 特性 | 描述 | |---------|-------------| | **歌词编辑器** | 使用结构标签编写和格式化歌词 | | **格式助手** | 由 AI 驱动的提示词和歌词格式化 | | **提示词模板** | 使用流派预设快速开始 | | **复用提示词** | 克隆任何先前生成的设置 | ### 🎧 专业界面 | 特性 | 描述 | |---------|-------------| | **Spotify 风格界面** | 简洁现代的设计，支持暗色/亮色模式 | | **底部播放器** | 带有波形图和进度条的全功能播放器 | | **库管理** | 浏览、搜索和整理您所有的音轨 | | **喜欢与播放列表** | 将收藏整理到自定义播放列表中 | | **实时进度** | 实时查看生成进度及队列位置 | | **局域网访问** | 在局域网内的任何设备上使用 | ### 🛠️ 内置工具 | 特性 | 描述 | |---------|-------------| | **音频编辑器** | 使用 AudioMass 进行裁剪、淡入淡出和应用特效 | | **分轨提取** | 使用 Demucs 分离人声、鼓、贝斯和其他音轨 | | **视频生成器** | 使用 Pexels 背景素材创建音乐视频 | | **渐变封面** | 漂亮的程序化生成的专辑封面（无需联网） | ## 💻 技术栈 | 层级 | 技术 | |-------|-------------| | **Frontend** | React 18, TypeScript, TailwindCSS, Vite | | **Backend** | Express.js, SQLite, better-sqlite3 | | **AI 引擎** | [ACE-Step 1.5](https://github.com/ace-step/ACE-Step-1.5) (Gradio API) | | **音频工具** | AudioMass, Demucs, FFmpeg | ## 📋 系统要求 | 需求 | 规格 | |-------------|---------------| | **Node.js** | 18 或更高版本 | | **Python** | 3.10+（推荐 3.11）或 Windows 便携版包 | | **NVIDIA GPU** | 4GB+ 显存（不使用 LLM 时），推荐 12GB+（使用 LLM 时） | | **CUDA** | 12.8（适用于 Windows 便携版包） | | **FFmpeg** | 用于音频处理 | | **uv** | Python 包管理器（标准安装时推荐使用） | ## ⚡ 快速开始 ### 🎯 Pinokio - 一键安装（推荐所有用户使用！） 在**任何平台**上启动和运行 ACE-Step UI 的最简单方法 — 无需终端，无需手动设置：

### 🪟 Windows - 一键启动（最简单！） ``` cd ace-step-ui start-all.bat ``` **大功告成！** 这将启动所有内容：在一个命令中启动 API + Backend + Frontend。 ### 🪟 Windows - 手动启动 ``` REM 1. Start ACE-Step Gradio (with API endpoints) cd C:\ACE-Step-1.5 python_embeded\python -m acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 REM 2. Start ACE-Step UI (in another terminal) cd ace-step-ui start.bat ``` ### Linux / macOS - 一键启动（最简单！） ``` cd ace-step-ui ./start-all.sh ``` **大功告成！** 这将启动所有内容：在一个命令中启动 Gradio + Backend + Frontend。 ### Linux / macOS - 手动启动 ``` # 在 ACE-Step-1.5 目录中启动 ACE-Step Gradio with API cd /path/to/ACE-Step-1.5 uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 # 在另一个终端中启动 ACE-Step UI cd ace-step-ui ./start.sh ``` ### Windows（标准安装） ``` REM 1. Start ACE-Step Gradio with API (in ACE-Step-1.5 directory) cd C:\path\to\ACE-Step-1.5 uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 REM 2. Start ACE-Step UI (in another terminal) cd ace-step-ui start.bat ``` 打开 **http://localhost:3000** 开始创作！ ## 📦 安装说明 ### 1. 安装 ACE-Step（AI 引擎） #### 🪟 Windows 便携版包（Windows 推荐） **在 Windows 上开始使用的最简单方法！** 该软件包包含所有预配置的内容： 1. **下载** [ACE-Step-1.5.7z](https://files.acemusic.ai/acemusic/win/ACE-Step-1.5.7z)（约 5GB） 2. **解压** 到 `C:\ACE-Step-1.5`（或您喜欢的位置） 3. **完成！** 该软件包包含 `python_embeded` 及所有依赖项 ✅ **支持 4GB 显存的 GPU** - 无需安装 LLM ✅ 已包含 **CUDA 12.8** ✅ **零配置烦恼** #### 标准安装（所有平台） ``` # 克隆 ACE-Step 1.5 - 开源的 Suno 替代方案 git clone https://github.com/ace-step/ACE-Step-1.5 cd ACE-Step-1.5 # 创建虚拟环境并安装 uv venv uv pip install -e . # 首次运行时自动下载模型（约 5GB） cd .. ``` ### 2. 安装 ACE-Step UI（本代码仓库） #### Linux / macOS ``` # 克隆 UI git clone https://github.com/fspecii/ace-step-ui cd ace-step-ui # 运行 setup 脚本（安装所有 dependencies） ./setup.sh ``` #### Windows ``` REM Clone the UI git clone https://github.com/fspecii/ace-step-ui cd ace-step-ui REM Run setup script (installs all dependencies) setup.bat ``` #### 手动安装（所有平台） ``` # 安装 frontend dependencies npm install # 安装 server dependencies cd server npm install cd .. # 复制 environment file # Linux/macOS： cp server/.env.example server/.env # Windows： copy server\.env.example server\.env ``` ## 🎮 使用方法 ### 第一步：启动 ACE-Step Gradio 服务器 **🪟 Windows 便携版包：** ``` cd C:\ACE-Step-1.5 python_embeded\python -m acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 ``` **Linux / macOS：** ``` cd /path/to/ACE-Step-1.5 uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 ``` **Windows（标准安装）：** ``` cd C:\path\to\ACE-Step-1.5 uv run acestep --port 8001 --enable-api --backend pt --server-name 127.0.0.1 ``` 在继续之前，请等待出现 "API endpoints enabled"。 ### 第二步：启动 ACE-Step UI **Linux / macOS：** ``` cd ace-step-ui ./start.sh ``` **Windows：** ``` cd ace-step-ui start.bat ``` ### 第三步：开始创作音乐！ | 访问方式 | URL | |--------|-----| | 本地 | http://localhost:3000 | | 局域网（其他设备） | http://YOUR_IP:3000 | ## ⚙️ 配置 编辑 `server/.env`： ``` # Server PORT=3001 # ACE-Step Gradio URL（必须与启动 ACE-Step 时使用的 --port 匹配） ACESTEP_API_URL=http://localhost:8001 # Database（本地优先，无云端） DATABASE_PATH=./data/acestep.db # 可选：用于视频背景的 Pexels API PEXELS_API_KEY=your_key_here ``` ## 🎼 生成模式 ### 简单模式 只需描述您想要的内容。剩下的交给 ACE-Step 处理。 ### 自定义模式 完全控制每一个参数： | 参数 | 描述 | |-----------|-------------| | **歌词** | 带有 `[Verse]`、`[Chorus]` 标签的完整歌词 | | **风格** | 流派、情绪、乐器、速度 | | **时长** | 30-240 秒 | | **BPM** | 每分钟 60-200 拍 | | **调性** | 音乐调性（C大调、A小调等） | ### AI 增强与思考模式 | 模式 | 作用 | 速度影响 | |------|-------------|--------------| | **AI 增强关闭** | 直接将您的风格标签发送给模型 | 最快 | | **AI 增强开启** | LLM 将您的标签丰富为详细的提示词，并生成合适的 BPM、调性和拍号 | 增加 10-20 秒 | | **思考模式** | 完整的 LLM 推理与音频代码生成 | 最慢，质量最好 | ### 批量大小与大量生成 | 设置 | 描述 | |---------|-------------| | **批量大小** | 每次任务生成的变体数量（1-4）。默认值为 **1**，以广泛兼容各种 GPU。值越高生成的变体越多，但占用的 VRAM 也越多。**8GB 显存 GPU 的用户应保持为 1。** | | **大量生成** | 排队多个独立的生成任务（1-10）。每个任务按顺序运行，因此对任何 GPU 都是安全的。 | | **LM 后端** | 在 **PT**（约 1.6 GB 显存）和 **VLLM**（约 9.2 GB 显存）之间选择。PT 是默认选项，适用于大多数 GPU。 | ## 🔧 内置工具 | 工具 | 描述 | |------|-------------| | **🎚️ 音频编辑器** | 剪切、裁剪、淡入淡出和应用特效 | | **🎤 分轨提取** | 分离人声、鼓、贝斯及其他音轨 | | **🎬 视频生成器** | 使用素材视频创建音乐视频 | | **🎨 专辑封面** | 自动生成的渐变封面 | ## 🐛 故障排除 | 问题 | 解决方案 | |-------|----------| | **ACE-Step 无法访问** | 确保运行 Gradio 服务器时带有 `--enable-api` 标志（参见“使用方法”部分） | | **CUDA 内存不足** | 使用 `--backend pt`（默认），将批量大小设置为 **1**，减少时长，或禁用思考模式 | | **4GB 显存 GPU - 内存不足** | 使用 **PT** 后端（默认），批量大小设为 **1**，并保持**思考模式关闭**。LLM 功能需要 12GB+ 显存 | | **流派听起来总像民谣** | 在风格部分启用 **AI 增强** 开关 — 它会使用合适的元数据丰富您的标签 | | **AttributeError: 'NoneType'** | 更新至最新的 ACE-Step-1.5（此修复已合并至 PR #109） | | **歌曲显示时长为 0:00** | 安装 FFmpeg：`sudo apt install ffmpeg`（Linux）或从 [ffmpeg.org](https://ffmpeg.org) 下载（Windows） | | **局域网访问无效** | 检查防火墙是否允许端口 3000 和 3001 | ## 🤝 参与贡献 **我们需要您的帮助，让 ACE-Step UI 变得更好！** 这是一个由社区驱动的项目，您的贡献让开源变得如此精彩。无论是修复 Bug、添加新功能、改进文档，还是分享想法 - 每一份贡献都至关重要！ ### 贡献方式 - 🐛 **报告 Bug** - 发现问题？提交一个 GitHub issue - 💡 **功能建议** - 有好点子？我们很乐意倾听 - 🔧 **提交 PR** - 随时欢迎代码贡献 - 📖 **改进文档** - 帮助其他人快速上手 - ⭐ **给仓库加星** - 展示您的支持！ ### 如何贡献 1. Fork 本代码仓库 2. 创建一个功能分支（`git checkout -b feature/amazing-feature`） 3. 提交您的更改（`git commit -m 'Add amazing feature'`） 4. 推该分支（`git push origin feature/amazing-feature`） 5. 发起一个 Pull Request ## 📣 保持联系

订阅并关注以获取：
🎥 视频教程和演示
🚀 新功能发布通知
💡 使用技巧和窍门
🎵 AI 音乐生成资讯

## 🙏 致谢 - **[ACE-Step](https://github.com/ace-step/ACE-Step-1.5)** - 具有革命性的开源 AI 音乐生成模型 - **[AudioMass](https://github.com/pkalogiros/AudioMass)** - Web 音频编辑器 - **[Demucs](https://github.com/facebookresearch/demucs)** - 音频源分离工具 - **[Pexels](https://www.pexels.com)** - 视频素材背景 ## 📄 许可证 本项目基于 [MIT 许可证](LICENSE) 开源。

⭐ 如果 ACE-Step UI 帮助您创作出了惊艳的音乐，请给本仓库加星！ ⭐

用 ❤️ 为开源 AI 音乐社区而作

停止为 Suno 付费。开始用 ACE-Step 创作。

标签：ACE-Step, AI音乐创作, AI音乐工具, AI音乐生成, DNS解析, React, SQLite, Suno替代方案, Syscalls, TailwindCSS, TypeScript, Vectored Exception Handling, 免费AI音乐, 前端界面, 安全插件, 开源音乐生成, 开源项目, 文本生成音乐, 本地优先, 本地音乐生成, 深度学习音乐生成, 自动作曲, 自定义脚本, 逆向工具, 音乐生成器