> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ComfyUI ACE-Step 1.5 Music Generation Guide
> Learn how to use ACE-Step 1.5 for AI music generation in ComfyUI. Complete guide with workflows, model downloads, and setup instructions for ComfyUI.
ACE-Step 1.5 is an open-source music generation model from ACE Studio and StepFun that turns a text description and optional lyrics into a complete song. ComfyUI runs it natively, so you can generate full tracks locally, from 10-second loops to multi-minute compositions.
At the core of the model is a language model planner paired with a Diffusion Transformer (DiT) audio decoder. The planner expands a simple query into a song blueprint, synthesizing structure, metadata, lyrics, and captions through Chain-of-Thought reasoning, and the DiT renders the audio. Alignment relies on the model's own internal mechanisms instead of an external reward model or human preference data.
Generation is fast enough for interactive sessions: under 2 seconds for a full song on an A100 and under 10 seconds on an RTX 3090. The under 4 GB VRAM configuration runs the DiT alone with the LM planner disabled. Training a LoRA on a few songs is enough to capture your own style.
Make sure your ComfyUI is updated.
* [Download ComfyUI](https://www.comfy.org/download)
* [Update Guide](/installation/update_comfyui)
Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
If you can't find them in the template, your ComfyUI may be outdated.
If nodes are missing when loading a workflow, possible reasons:
1. You are not using the latest ComfyUI version (Nightly version)
2. Some nodes failed to import at startup
* [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.
So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
**Model highlights**:
* **Commercial-grade quality**: Quality beyond most commercial music models, with a musical coherence score of 4.72
* **Fast generation**: A full song in under 2 seconds on an A100, or under 10 seconds on an RTX 3090
* **Long-form output**: Durations from 10 seconds up to 10 minutes
* **50+ languages**: Strong support for English, Chinese, Japanese, Korean, Spanish, German, French, Portuguese, Italian, and Russian
* **LoRA fine-tuning**: Lightweight personalization through LoRA training in ComfyUI
## Option 1: All-in-One Checkpoint (Recommended)
The AIO version packages all models into a single checkpoint file, making it easier to download and manage.
ACE-Step 1.5 Music Generation AIO
Input style tags and lyrics to generate a full song. The workflow uses the ACE-Step 1.5 model to produce commercial-grade music in under 10 seconds on consumer hardware.
Open in Comfy Cloud
Download JSON or search "ACE-Step 1.5 Music Generation AIO" in Template Library
### AIO Model Download
All-in-one checkpoint file (recommended for most users).
**AIO Model Storage Location**
```
📂 ComfyUI/
├── 📂 models/
│ └── 📂 checkpoints/
│ └── ace_step_1.5_turbo_aio.safetensors
```
## Option 2: Split Model Files
The split version allows you to download individual model components separately.
ACE-Step 1.5 Music Generation Workflow
Input a text prompt describing the music style and optional lyrics. Generate a full, high-quality audio song in under 10 seconds on consumer hardware.
Open in Comfy Cloud
Download JSON or search "ACE-Step 1.5 Music Generation Workflow" in Template Library
### Split Model Downloads
Diffusion model.
Text encoder (0.6B).
Text encoder (1.7B).
VAE model.
**Split Models Storage Location**
```
📂 ComfyUI/
├── 📂 models/
│ ├── 📂 diffusion_models/
│ │ └── acestep_v1.5_turbo.safetensors
│ ├── 📂 text_encoders/
│ │ ├── qwen_0.6b_ace15.safetensors
│ │ └── qwen_1.7b_ace15.safetensors
│ └── 📂 vae/
│ └── ace_1.5_vae.safetensors
```
## ACE-Step 1.5 Key Features in ComfyUI
### Chain-of-Thought Planning
The ACE-Step 1.5 model synthesizes metadata, lyrics, and captions via Chain-of-Thought reasoning to guide the diffusion process, resulting in more coherent long-form compositions.
### Hybrid LM + DiT Architecture
ACE-Step 1.5 combines a Language Model that plans the song structure with a Diffusion Transformer (DiT) that handles audio synthesis, all running natively in ComfyUI.
## Coming Soon to ComfyUI
These features are available in ACE-Step 1.5 but not yet supported in ComfyUI:
* **Cover**: Give the model any song as input along with a new prompt and lyrics, and it will reimagine the track in a completely different style
* **Repaint**: Select a segment, regenerate just that section, and the model stitches it back in while keeping everything else untouched
## ACE-Step 1.5 ComfyUI Related Resources
* [Project Page](https://ace-step.github.io/)
* [Hugging Face](https://huggingface.co/Comfy-Org/ace_step_1.5_ComfyUI_files)
* [GitHub](https://github.com/ace-step/ACE-Step)
* [Blog Post](https://blog.comfy.org/p/ace-step-15-is-now-available-in-comfyui)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.