ACE-Step 1.5

1. ACE-Step 1.5 là gì?

ACE-Step 1.5 là mô hình AI tạo nhạc mã nguồn mở. Bạn mô tả bài hát mình muốn (ví dụ "nhạc điện tử sôi động, bass mạnh") hoặc dán lời bài hát, bấm một nút, và nó tạo ra cả bài nhạc có nhạc cụ, có thể có giọng hát. Nó chạy ngay trên máy tính của bạn và giao diện là một trang web mở trong trình duyệt. Dự án so sánh chất lượng của mình với các dịch vụ tạo nhạc thương mại như Suno; đó là so sánh do chính nhóm tác giả đưa ra, bạn nên tự nghe thử.

Dự án miễn phí, giấy phép MIT, không cần tài khoản. Chạy trên máy thì không mất phí theo bài.

Hợp với bạn nếu:

• Bạn cần nhạc nền cho video, podcast, game và muốn thử nhiều phiên bản mà không bị giới hạn lượt tạo của dịch vụ trực tuyến.
• Máy bạn có card đồ họa NVIDIA (tài liệu nói từ khoảng 4 GB bộ nhớ card là chạy được chế độ cơ bản).
• Bạn chấp nhận làm vài bước cài đặt và tải file dung lượng lớn một lần.

Chưa hợp nếu:

• Máy bạn là laptop văn phòng không có card rời. Tài liệu nói chạy bằng CPU vẫn được nhưng chậm hơn rõ rệt. Khi đó nên thử bản dùng thử trên web mà dự án giới thiệu (xem câu hỏi ở mục 7).
• Bạn cần hát tiếng Việt chắc chắn. README nói hỗ trợ lời bài hát hơn 50 ngôn ngữ nhưng không liệt kê tên từng ngôn ngữ, nên hãy tự thử tiếng Việt trước.
• Bạn định dùng nhạc để kiếm tiền hoặc đăng lên nền tảng có kiểm tra bản quyền. Nhóm tác giả khuyên kiểm tra độ độc đáo của tác phẩm và ghi rõ có dùng AI. Đây là việc của bạn, dự án không chịu trách nhiệm.

2. Cần chuẩn bị gì?

Theo tài liệu chính thức:

	Yêu cầu
Hệ điều hành	Windows (hướng dẫn này tập trung vào Windows); có cả macOS và Linux
Card đồ họa	Nên có card NVIDIA hỗ trợ CUDA. Bản ghi sẵn trên Windows yêu cầu CUDA 12.8
Bộ nhớ card (VRAM)	Từ 4 GB cho chế độ cơ bản (chỉ tạo nhạc); từ 6 GB nếu bật thêm mô hình ngôn ngữ giúp viết lời và chỉnh bài
Ổ đĩa trống	Khoảng 10 GB cho các mô hình chính, cộng chỗ cho file cài
Python	Với bản "portable" trên Windows thì không cần tự cài Python, vì Python đã nằm sẵn trong gói

Gói "portable" là gói đã cài sẵn mọi thứ: bạn chỉ giải nén rồi chạy. Gói này nặng khoảng 2,4 GB. Để giải nén file .7z, bạn cần phần mềm 7-Zip (miễn phí, tải ở https://www.7-zip.org).

Lần chạy đầu tiên, chương trình tự tải thêm các mô hình AI từ Internet, nên cần mạng ổn định và chờ vài chục phút nếu mạng chậm.

Bản phát hành gần nhất trên GitHub lúc viết bài là v0.1.8 (18/5/2026); mã nguồn vẫn được cập nhật sau đó.

3. Cài đặt từng bước

Bước 1: Tải gói portable cho Windows

Mở trang https://github.com/ACE-Step/ACE-Step-1.5 và dùng đúng liên kết tải "portable package" ghi trong phần Quick Start của README, hoặc mở trực tiếp:

https://files.acemusic.ai/acemusic/win/ACE-Step-1.5.7z

Lưu ý bảo mật: tác giả cảnh báo có tên miền giả mạo dự án. Chỉ dùng liên kết đi ra từ trang GitHub chính thức ở trên, đừng tải từ trang quảng cáo hoặc bài đăng lạ.

Thấy gì là đúng: một file ACE-Step-1.5.7z nặng khoảng 2,4 GB.

Bước 2: Giải nén

Nhấp chuột phải vào file, chọn 7-Zip → Extract to "ACE-Step-1.5" (Giải nén vào thư mục). Chọn một ổ còn trống nhiều chỗ và đường dẫn ngắn, không có dấu tiếng Việt, ví dụ D:\ACE-Step-1.5.

Thấy gì là đúng: trong thư mục có các file như start_gradio_ui.bat và thư mục python_embedded.

Bước 3: Chạy giao diện

Nhấp đúp vào file start_gradio_ui.bat.

Thấy gì là đúng: một cửa sổ đen (dòng lệnh) mở ra và chạy chữ. Lần đầu nó tải mô hình nên có thể đứng yên khá lâu. Đừng đóng cửa sổ này khi bạn còn dùng chương trình. Khi sẵn sàng, mở trình duyệt vào địa chỉ:

http://localhost:7860

Bạn sẽ thấy giao diện web của ACE-Step (một trang Gradio với các mục như Settings, Generation, Results).

Cách khác (nếu bạn quen dòng lệnh): cài bằng uv

Cần Python 3.11 hoặc 3.12 và Git. Tài liệu hướng dẫn cài công cụ uv rồi chạy:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
git clone https://github.com/ACE-Step/ACE-Step-1.5.git
cd ACE-Step-1.5
uv sync
uv run acestep

Sau đó cũng mở http://localhost:7860.

4. Dùng lần đầu

1. Trong giao diện web, mở phần Settings và bấm Initialize Service để nạp mô hình. Ô trạng thái sẽ cho biết card đồ họa và dung lượng bộ nhớ chương trình phát hiện được, và tự chỉnh thời lượng tối đa phù hợp với máy bạn.
2. Ở tab Generation, chọn chế độ Simple.
3. Gõ mô tả bài hát vào ô "Song Description". Ví dụ trong tài liệu: "jazz trio playing in a smoky bar". Nếu chỉ muốn nhạc không lời, tích ô Instrumental.
4. Bấm Create Sample để chương trình tạo mô tả và lời, rồi bấm Generate Music.
5. Ở phần kết quả, bấm nút phát để nghe và tải file về.

Thấy gì là đúng: sau ít phút (nhanh hơn nhiều nếu máy có card mạnh) bạn thấy một hay nhiều bản nhạc với nút phát. Số bản tạo mỗi lần (Batch Size) mặc định là 2.

Muốn tự viết lời, dùng chế độ Custom và chia lời bằng nhãn như [Verse 1], [Chorus].

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
Cửa sổ báo "No GPU detected, running on CPU"	Không nhận ra card đồ họa, hoặc cài nhầm bản PyTorch chỉ chạy CPU	Cập nhật driver NVIDIA; chạy công cụ chẩn đoán python scripts/check_gpu.py của dự án; với card AMD dùng file start_gradio_ui_rocm.bat
Báo hết bộ nhớ (out of memory)	Card không đủ VRAM cho mô hình đang chọn	Dùng mô hình nhỏ (tài liệu gợi ý bản "2B turbo" cho card dưới 8 GB), tắt mô hình ngôn ngữ, giảm thời lượng hoặc số bản tạo mỗi lần
Trình duyệt không mở được http://localhost:7860	Chương trình chưa chạy xong, hoặc cổng 7860 đang bị ứng dụng khác dùng	Chờ cửa sổ đen báo sẵn sàng; đóng ứng dụng khác dùng cổng đó; cổng có thể đổi trong cấu hình (biến PORT)
Dừng lâu ở bước tải mô hình	Mô hình dung lượng lớn, mạng chậm hoặc bị chặn	Chờ; thử đổi nguồn tải trong file .bat (dòng DOWNLOAD_SOURCE, chọn huggingface hoặc modelscope)
Windows hoặc phần mềm diệt virus chặn file .bat	File chạy lệnh chưa ký số	Chỉ cho phép nếu bạn tải từ nguồn chính thức ở Bước 1

6. Gỡ cài đặt / cập nhật

Gỡ: gói portable không cài vào hệ thống, nên chỉ cần đóng cửa sổ đen rồi xóa thư mục ACE-Step-1.5 bạn đã giải nén. Các mô hình tải về có thể nằm trong thư mục này hoặc trong bộ nhớ đệm của công cụ tải; tài liệu không nói rõ, nên sau khi xóa hãy kiểm tra ổ đĩa xem dung lượng đã được trả lại chưa.

Cập nhật: gói có sẵn file check_update.bat, dùng để kiểm tra và cập nhật từ GitHub. Tài liệu ghi cần thư mục PortableGit trong gói để cập nhật tự động. Nếu hơi phức tạp, bạn có thể tải gói portable mới và giải nén sang thư mục khác.

7. Câu hỏi hay gặp

Có mất tiền không? Không. Dự án miễn phí, giấy phép MIT.

Tôi không có card NVIDIA thì sao? Tài liệu nói có thể chạy bằng CPU, Mac chip Apple hoặc card AMD/Intel, nhưng chậm hơn hoặc cần cách cài khác. README còn giới thiệu trang dùng thử miễn phí không cần card đồ họa tại https://acemusic.ai ; đó là trang do dự án nêu, hãy tự cân nhắc trước khi dùng dịch vụ web.

Dữ liệu của tôi có bị gửi đi không? Khi chạy trên máy bằng cách ở mục 3, mô hình chạy cục bộ. Chỉ lần đầu chương trình tải mô hình từ Internet.

Nhạc tạo ra có dùng thương mại được không? README chỉ nói dự án dùng giấy phép MIT và khuyến nghị tự kiểm tra bản quyền tương đồng và ghi rõ có dùng AI. Với dự án thương mại hãy tự tìm hiểu thêm.

Giao diện có tiếng Việt không? Trong file cấu hình của gói portable, dòng chọn ngôn ngữ giao diện liệt kê en, zh, he, ja; không có tiếng Việt.