ComfyUI Node
ACE-Step Text to Music
A ComfyUI node in Audio/ACE-Step with 23 inputs and 3 outputs.
ACE-Step Text to Music
- lora_info
- audio
- audio_path
- metadata
◄caption►
◄checkpoint_dirAce-Step1.5►
◄config_pathacestep-v15-turbo►
◄lm_model_pathacestep-5Hz-lm-1.7B►
◄duration30.00►
◄batch_size2►
◄seed-1►
◄inference_steps8►
◄deviceauto►
◄lyrics►
◄bpm0►
◄keyscale►
◄timesignature►
◄vocal_languageunknown►
◄instrumentalfalse►
◄guidance_scale7.00►
◄shift1.00►
◄thinkingtrue►
◄lm_temperature0.00►
◄quantizationNone►
◄compile_modelfalse►
◄audio_formatflac►
CategoryAudio/ACE-Step
Inputs (23)
| Name | Type | Default | Description |
|---|---|---|---|
| caption | STRING | Text prompt or natural language description for music generation. | |
| checkpoint_dir | COMBO | Ace-Step1.5 | Directory containing ACE-Step model weights (DiT model). |
| config_path | COMBO | acestep-v15-turbo | Specific model configuration to use (e.g., v1.5 turbo). |
| lm_model_path | COMBO | acestep-5Hz-lm-1.7B | Path to the language model used for generating lyrics and metadata. |
| duration | FLOAT | 30.0010–600 | Target duration of the generated music in seconds. |
| batch_size | INT | 21–8 | Number of audio samples to generate in a single batch. |
| seed | INT | -1-1–18446744073709550000 | Random seed for reproducibility. Set to -1 for random generation. |
| inference_steps | INT | 81–64 | Number of diffusion steps. Higher values (e.g., 25-50) improve quality but are slower. |
| device | COMBO | auto | Computing platform to run the model on. |
| lora_infoopt | ACE_STEP_LORA_INFO | Optional LoRA model information for style fine-tuning. | |
| lyricsopt | STRING | Song lyrics. Leave empty for automatic generation by the language model. | |
| bpmopt | INT | 00–300 | Beats per minute. 0 for automatic detection. |
| keyscaleopt | STRING | Musical key and scale (e.g., C Major). | |
| timesignatureopt | STRING | Musical time signature (e.g., 4/4). | |
| vocal_languageopt | STRING | unknown | Vocal language (e.g., zh, en, ja, auto, unknown). Accepts string input from CreateSample node. |
| instrumentalopt | BOOLEAN | false | Whether to generate instrumental music only (no vocals). |
| guidance_scaleopt | FLOAT | 7.001–15 | Strength of prompt following. |
| shiftopt | FLOAT | 1.001–5 | Sequence length scaling factor, default is 1.0. |
| thinkingopt | BOOLEAN | true | Whether to show the language model's Chain-of-Thought reasoning. |
| lm_temperatureopt | FLOAT | 0.000–2 | Sampling temperature for the language model. 0.0 is most stable (recommended). |
| quantizationopt | COMBO | None | Model quantization (e.g., int8). Reduces VRAM usage but requires torchao and compile_model=True. Incompatible with LoRA. |
| compile_modelopt | BOOLEAN | false | Whether to use torch.compile to optimize the model. Required for quantization. Slow on first run but faster afterwards. |
| audio_formatopt | COMBO | flac | Output audio file format. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| audio | AUDIO | — |
| audio_path | STRING | — |
| metadata | STRING | — |