← 返回项目库

ACE-Step 音乐生成模型

ACE-Step 音乐创作源码配套的中文本地预览工作台,可生成可试听的确定性 WAV 演示音频。

交付包保留上游 ACE-Step 音乐生成模型源码,并新增一个无需 GPU、checkpoint 或外部 API 的本地预览入口。预览工作台提供音乐描述、风格标签、歌词、音频试听、音乐库、变体、歌词段落分析、四步流程和运行边界说明;预览音频由本地确定性合成器生成,不冒充 ACE-Step 模型推理结果。

真实界面

项目截图

共 6 张

创作工作台
音乐库
变体与重绘
歌词与段落
生成流程
运行配置

Capabilities

核心功能

中文音乐描述与风格标签创作表单
本地确定性 WAV 音频生成与浏览器试听
音乐库列表、音频播放与收藏切换
基于作品的变体强度和修改方向工作台
歌词段落识别与可继续编辑的结构展示
四步生成流程与最近任务状态
原生 ACE-Step、模型权重和外部 API 边界说明
固定种子、时长和推理步数等复现参数

适用场景

在无 GPU 环境快速验收音乐创作产品的信息架构与交互
学习 ACE-Step 原生源码入口、依赖和模型部署边界
用本地演示音频验证生成、试听、变体与交付流程

适合谁

希望学习音乐生成产品交互、验证音频工作流、研究 ACE-Step 源码或在具备 GPU 与模型权重后继续部署原生模型的开发者和社群成员。

商业化思路

用于社群学习、研究和技术验证;本交付不承诺云端生成服务,也不包含模型权重、托管 API 或生产级账号体系。

你会拿到什么

  • 固定提交版本的 ACE-Step 源码包与原始 Apache-2.0 LICENSE
  • 中文本地预览入口、自动化测试和运行说明
  • 六张绑定中文功能界面截图及对应可审计 manifest

部署流程

  1. 1解压源码包,在项目根目录执行 python3 preview_app.py --host 127.0.0.1 --port 7865 启动本地预览。
  2. 2用浏览器访问服务地址,按创作工作台、音乐库、变体与重绘、歌词与段落、生成流程和运行配置依次验收;原生模型部署另行按 README 准备 GPU 与 checkpoint。

真实验证结果

已通过 py_compile、4 项本地单元测试、固定运行时 smoke、6 个 1440×900 中文功能页面的绑定浏览器证据,以及独立 HTTP 端到端验收。端到端验收实际调用健康、状态、音频下载、生成、变体、歌词分析、工作流和收藏接口,并解析初始、生成和变体 WAV 为 44.1 kHz 双声道 PCM。浏览器证据 HTTP 200、可见数据和标题断言通过,控制台错误、破图、404、登录页和横向溢出均为 0。

部署前须知

本地预览使用确定性合成器,不是 ACE-Step checkpoint 的模型输出;不提供真实 AI 生成质量、云端 API、账号、队列或生产权限。原生 acestep/gui.py 仍需 checkpoint、CUDA/GPU 和重量级依赖;模型权重未随包交付。预览数据保存在进程级临时目录,服务重启后恢复演示初始状态。

部署难度

中等

最低配置

Python 3.9+ 与现代浏览器即可运行本地预览入口;原生 ACE-Step 推理仍需按上游说明准备 CUDA/GPU、checkpoint 和完整依赖。

开源许可证

Apache License 2.0

最后验证

2026-09-04

技术栈

Python标准库 http.server标准库 waveACE-Step 原生 Gradio UICUDA / PyTorch(原生模型路径)

授权说明

交付包原样保留仓库根目录 LICENSE;本地预览适配器与中文说明随源码交付,使用、修改和再分发须遵守 Apache License 2.0 及上游版权和通知要求。

Release notes

版本记录

1 个已发布版本

vcn-3900d6001f00 当前推荐

基于上游固定提交增加中文本地预览工作台、确定性 WAV 演示生成器、音乐库、变体、歌词结构、流程和运行边界说明;补充单元测试与本地运行文档。

部署要求:本地预览需要 Python 3.9+ 和现代浏览器;原生 ACE-Step 路径需要按上游说明准备 CUDA/GPU、checkpoint、PyTorch、Gradio 及完整依赖。

已知问题:本地预览不代表模型推理结果,模型权重、外部 API、生产认证和持久化数据库未包含在交付中。

登录后领取