开源项目解析
ACE-Step
音乐生成基座:文生音乐、歌词编辑、音色复刻、remix。
8GB 显存出音乐Apache 商用
读懂层
2 张 · 架构图 / 时序图
DeepWiki 架构页 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
它管哪几个决定
声音后期配音:改词不重出视频
7/10 家有官方说法自持能力
权重在不在本地可下载到本地
种子能不能填可填
换掉它要动几处一处
整条音频链在本机,换掉只影响配乐那一段
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1conda create -n ace_step python=3.103.10 起步
- 2pip install -e .可编辑安装;Windows 要单独装 CUDA 版 torch
- 3acestep --port 7865权重自动下到 `~/.cache/ace-step/checkpoints`,不用手动放
改哪个文件能改什么
--cpu_offload true --overlapped_decode true**两个一起开才降到 8GB**,只开一个不够--bf16默认开;**macOS 上要显式 `--bf16 false`**,否则报错--torch_compile true提速。Windows 上要先 `pip install triton-windows`歌词结构标签`[verse]` `[chorus]` `[bridge]` 直接写在歌词里控制段落坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
歌词编辑一次只能改一小段,改多了失真 —— 模型限制,不是参数问题
小语种官方承认数据不均衡,冷门语种表现明显更差
从 Gradio 跑效果不如 ComfyUIissue #54(开着):「Comfy 集成的效果明显比仓库默认那套更准」 —— 同一个模型,两个前端出的东西不一样。默认界面不代表模型上限
LoRA 训练issue #33 是全仓最热的一条(86 条回复,开着):24GB 显存上训 LoRA 怎么弄。#329 还在要训练指南 —— 推理门槛 8GB,训练完全是另一回事
长时间开着界面issue #201:Gradio 界面内存泄漏,开着。批量跑完记得重启
AMD 显卡issue #87 开着 —— A 卡这条线还没铺好
教程
官方文档、作者本人的视频,以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
ACE-Step
A Step Towards Music Generation Foundation Model
Project |
Hugging Face |
ModelScope |
Space Demo |
Discord |
Technical Report |
ACE-Step v1.5
Table of Contents
- ✨ Features
- 📦 Installation
- 🚀 Usage
- 📱 User Interface Guide
- 🔨 Train
📝 Abstract
We introduce ACE-Step, a novel open-source foundation model for music generation that overcomes key limitations of existing approaches and achieves state-of-the-art performance through a holistic architectural design. Current methods face inherent trade-offs between generation speed, musical coherence, and controllability. For instance, LLM-based models (e.g., Yue, SongGen) excel at lyric alignment but suffer from slow inference and structural artifacts. Diffusion models (e.g., DiffRhythm), on the other hand, enable faster synthesis but often lack long-range structural coherence.
ACE-Step bridges this gap by integrating diffusion-based generation with Sana’s Deep Compression AutoEncoder (DCAE) and a lightweight linear transformer. It further leverages MERT and m-hubert to align semantic representations (REPA) during training, enabling rapid convergence. As a result, our model synthesizes up to 4 minutes of music in just 20 seconds on an A100 GPU—15× faster than LLM-based baselines—while achieving superior musical coherence and lyric alignment across melody, harmony, and rhythm metrics. Moreover, ACE-Step preserves fine-grained acoustic details, enabling advanced control mechanisms such as voice cloning, lyric editing, remixing, and track generation (e.g., lyric2vocal, singing2accompaniment).
Rather than building yet another end-to-end text-to-music pipeline, our vision is to establish a foundation model for music AI: a fast, general-purpose, efficient yet flexible architecture that makes it easy to train sub-tasks on top of it. This paves the way for developing powerful tools that seamlessly integrate into the creative workflows of music artists, producers, and content creators. In short, we aim to build the Stable Diffusion moment for music.
📢 News and Updates
- 🎉 2026.01.28: Released ACE-Step v1.5 - Our latest and most advanced model is now available!
- 📃 2025.06.02: Released ACE-Step Technical Report (PDF).
- 🎮 2025.05.14: Add Stable Audio Open Small sampler pingpong. Use SDE to achieve better music consistency and quality, including lyric alignment and style alignment. Use a better method to re-implement Audio2Audio
- 🎤 2025.05.12: Release RapMachine and fix lora training issues
- See ZH_RAP_LORA.md for details. Audio Examples: https://ace-step.github.io/#RapMachine
- See TRAIN_INSTRUCTION.md for detailed training instructions.
- 🔥 2025.05.10: Memory Optimization Update
- Reduced Max VRAM to 8GB, making it more compatible with consumer devices
- Recommended launch options:
bash
acestep --torch_compile true --cpu_offload true --overlapped_decode true
Windows need to install triton:
pip install triton-windows
- 📢 2025.05.09: Graidio Demo support Audio2Audio. ComfyUI: Ace_Step_4x_a2a.json
- 🚀 2025.05.08: ComfyUI_ACE-Step node is now available! Explore the power of ACE-Step within ComfyUI. 🎉
- 🚀 2025.05.06
……(后略,见原文)判断
优势
- 4090 上 1 分钟音乐 1.74 秒,快到可以反复试
- 最低 8GB,门槛在本专项里最低
- Apache-2.0,出的曲子商用没有授权问题
局限
- 歌词编辑一次只能改一小段,否则失真
- 数据不均衡,小语种表现弱
- 风格相似可能带来版权争议,官方自己提示了
不适用
需要特定曲风精确复刻时。
同管这些决定的其它项目
MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…pyvideotrans识别 → 翻译 → 合成 → 回封装的整条流水线,做跨语言配音与字幕。…LatentSync字节开源的口型同步:音频直接驱动潜空间扩散,不经过中间的运动表示。…IndexTTS2B 站开源的零样本语音合成:给一段参考音就能克隆音色,情感可以单独指定。中英双语。…Ollama一条命令在本机跑开源大模型。写脚本、翻译这两段靠它才不出本机。…DiffSynth-Studio魔搭扩散模型工程框架,覆盖图像、视频、音乐推理与训练;近期加入 FLUX.3、MOS…MoneyPrinterTurbo给个主题或关键词,一键出高清短视频,含字幕与配音。…NarratoAI用大模型一键解说并剪辑现成视频。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…OpenMontage让 Agent 编排视频生产:通过声明式流水线组织素材、生成、字幕、音频与合成。…乘风视频剪辑 Skills用 Claude Code Skills 做的视频剪辑 Agent。中文侧最成型的一…OpenChatCut对话式视频剪辑器,本地优先。你说「第二条音轨第 8 秒加个故障转场」,它就去改那一刀…video-podcast-maker给编码 Agent 用的 skill:给一个主题,出一条 4K 带解说的讲解片。11…ComfyUI 官方工作流模板ComfyUI 内置的那批官方工作流模板与子图蓝图的真身仓库。…ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…短视频工厂跨平台桌面应用:给提示词文本加分镜素材,自动剪出产品营销或泛内容短视频。集成文案生成…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…LiveTalking实时交互流式数字人引擎,音视频同步对话。支持 ernerf、musetalk、wav…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…PromptLensAI 视频提示词分析工具:丢进一条别人的视频,反推出它的提示词与创作脚本,并做画面分…
github README + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。