# Генерация музыки ACE-Step

ACE-Step 1.5 — это прорыв в генерации музыки с открытым исходным кодом, которого все ждали. Он генерирует **полные песни с вокалом и инструментами** по текстовым подсказкам, соперничая с коммерческими сервисами, такими как Suno — но работает локально на вашей GPU с **Лицензия MIT**. Главная особенность? Ему требуется **менее 4 ГБ видеопамяти (VRAM)**, что делает его самым доступным инструментом ИИ для музыки. Сгенерируйте полный трек за 2–8 секунд на RTX 4090.

## Ключевые особенности

* **Генерация полной песни**: Вокал + инструменты + эффекты за один проход
* **< 4 ГБ VRAM**: Работает даже на самых дешёвых GPU (RTX 3060, даже GTX 1060!)
* **2–8 секунд на трек**: Почти мгновенная генерация на современных GPU
* **Лицензия MIT**: Полное коммерческое использование, без ограничений
* **Поддержка текста песен**: Пишите собственные тексты со структурой куплет/припев
* **Контроль стиля**: Теги жанра, настроение, темп, инструментация
* **Интеграция с ComfyUI**: Узловой рабочий процесс для сложных музыкальных конвейеров

## Требования

| Компонент | Минимум           | Рекомендуется      |
| --------- | ----------------- | ------------------ |
| GPU       | Любой с 4 ГБ VRAM | RTX 3060 или лучше |
| VRAM      | 4 ГБ              | 6 ГБ+              |
| ОЗУ       | 8GB               | 16GB               |
| Диск      | 10GB              | 15GB               |
| Python    | 3.10+             | 3.11               |

**Рекомендуемый GPU на Clore.ai**: RTX 3060 6 ГБ (\~$0.15–0.3/день) — да, самый дешёвый GPU подходит!

### Справка по скорости

| GPU           | Время генерации (30 с трек) |
| ------------- | --------------------------- |
| GTX 1060 6GB  | \~15–20 сек                 |
| RTX 3060 12GB | \~6–10 сек                  |
| RTX 3080 10GB | \~4–6 сек                   |
| RTX 4090 24GB | \~2–3 сек                   |

## Установка

### Автономный

```bash
git clone https://github.com/ace-step/ACE-Step.git
cd ACE-Step
pip install -e .

# Или через pip (если доступно)
pip install ace-step
```

### Интеграция с ComfyUI

```bash
cd ComfyUI/custom_nodes
git clone https://github.com/ace-step/ComfyUI-ACE-Step
pip install -r ComfyUI-ACE-Step/requirements.txt
# Перезапустите ComfyUI — узлы ACE-Step появятся
```

## Быстрый старт

### Установка

ACE-Step — это веб-приложение на Gradio, а не пакет pip. Установите из Git:

```bash
# Клонируйте и настройте
git clone https://github.com/ACE-Step/ACE-Step-1.5.git
cd ACE-Step-1.5

# Вариант A: uv (рекомендуется)
pip install uv
uv sync

# Вариант B: pip
pip install -r requirements.txt
```

### Запуск веб-интерфейса

```bash
# Запустите интерфейс Gradio
python app.py --port 7860 --share

# Для низкого объёма VRAM (< 6 ГБ):
python app.py --port 7860 --half
```

Откройте `http://localhost:7860` в вашем браузере. Интерфейс включает:

1. **Поле подсказки** — опишите стиль: "жизнерадостный электронный поп, 120 BPM"
2. **Поле для текста песни** — пишите куплеты с помощью `[Куплет]`, `[Припев]` тегов
3. **Ползунок длительности** — 15–120 секунд
4. **Кнопка генерации** — нажмите и подождите 2–8 секунд

### Генерация с текстом (веб-интерфейс)

Введите в поле для текста песни:

```
[Куплет 1]
Я арендую GPU поздно ночью
Серверы гудят, экраны так ярки
Тренирую модели, гонюсь за мечтой
Ничто не такое, каким кажется

[Припев]
Сегодня мы создаём что-то новое
Будущее — всего лишь подсказка вдали
С каждым токеном, каждой строкой
Код и музыка переплетаются
```

Установите подсказку на: `инди-рок баллада, акустическая гитара, эмоционально, мужской вокал`

### Использование через CLI / конвейер

```bash
# Генерация из командной строки с использованием скрипта конвейера напрямую
cd ACE-Step-1.5
python acestep/acestep_v15_pipeline.py \
  --prompt "lo-fi hip hop, chill, rainy day, piano, soft drums" \
  --lyrics "" \
  --duration 30 \
  --output output.wav
```

### Интеграция ComfyUI (пакетная обработка)

```bash
# Установите узлы ComfyUI для пакетной генерации
cd ComfyUI/custom_nodes
git clone https://github.com/ACE-Step/ComfyUI-ACE-Step
pip install -r ComfyUI-ACE-Step/requirements.txt
# Перезапустите ComfyUI — узлы ACE-Step появятся в меню узлов
```

Узлы ComfyUI позволяют пакетно генерировать несколько треков с разными подсказками в визуальном рабочем процессе.

### Теги стиля

Контролируйте генерацию с помощью тегов стиля:

```python
# Теги жанра
"pop", "rock", "electronic", "hip-hop", "jazz", "classical", "metal",
"lo-fi", "synthwave", "ambient", "folk", "R&B", "country"

# Теги настроения
"happy", "sad", "energetic", "chill", "dark", "epic", "romantic"

# Теги инструментов
"piano", "guitar", "drums", "bass", "synth", "strings", "violin"

# Теги вокала
"male vocal", "female vocal", "choir", "no vocals", "humming"

# Технические теги
"120 BPM", "minor key", "major key", "4/4 time"
```

## Веб-интерфейс

```bash
cd ACE-Step
python app.py --port 7860
# Откройте http://localhost:7860
```

Веб-интерфейс предоставляет:

* Ввод текстовой подсказки с предустановками стиля
* Редактор текста песен с форматированием куплет/припев
* Ползунки длительности и качества
* Просмотр формы волны в реальном времени
* Скачивание в формате WAV или MP3

## Сценарии использования на Clore.ai

| Случай использования               | Настройка                    | Стоимость    |
| ---------------------------------- | ---------------------------- | ------------ |
| Фоновая музыка для видео           | RTX 3060, пакетная генерация | \~$0.15/день |
| Прототипирование песен / демо      | RTX 3080, в реальном времени | \~$0.3/день  |
| Конвейер музыкального производства | RTX 4090 + ComfyUI           | \~$1/день    |
| Интро/аутро для подкастов          | Любая GPU, одиночный прогон  | \~$0.15/день |

## Советы для пользователей Clore.ai

* **Самая дешевая задача ИИ, какая только возможна**: По цене $0.15/день за RTX 3060 генерируйте сотни треков за копейки
* **Пакетная генерация ночью**: Арендуйте GPU на 8 часов ($0.05–0.1), сгенерируйте 500+ треков
* **ComfyUI для конвейеров**: Сочетайте с генерацией изображений для рабочих процессов по созданию обложек альбомов
* **Качество экспорта**: Генерируйте в максимальном качестве, затем при необходимости обрабатывайте в DAW
* **Смешение стилей**: Комбинируйте жанры в подсказках: "lo-fi jazz hip hop с потрескиванием винила" работает удивительно хорошо

## Устранение неполадок

| Проблема                    | Решение                                                                                                                     |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| CUDA не найдена             | Убедитесь, что PyTorch установлен с поддержкой CUDA: `pip install torch --index-url https://download.pytorch.org/whl/cu121` |
| Загрузка модели медленная   | Установите `HF_HUB_ENABLE_HF_TRANSFER=1` для более быстрой загрузки                                                         |
| Аудио искажено              | Попробуйте понизить температуру (0.7) или уменьшить количество шагов инференса                                              |
| Недостаточно памяти на 4 ГБ | Уменьшите длительность до 15 секунд; обновитесь до GPU с 6 ГБ                                                               |
| Узлы ComfyUI отсутствуют    | Перезапустите ComfyUI после установки пользовательских узлов                                                                |

## ACE-Step против Suno и AudioCraft

| Функция               | ACE-Step 1.5      | Suno v4            | AudioCraft        |
| --------------------- | ----------------- | ------------------ | ----------------- |
| Полные песни          | ✅                 | ✅                  | ❌ (только музыка) |
| Вокал                 | ✅                 | ✅                  | ❌                 |
| Локальный/самохостинг | ✅                 | ❌ (облако)         | ✅                 |
| Лицензия              | MIT               | Проприетарный      | MIT               |
| Мин. VRAM             | 4 ГБ              | N/A                | 16GB              |
| Скорость (30 с)       | 2–8 сек           | \~30 сек           | \~60 сек          |
| Стоимость             | $0.15/день за GPU | $10/месяц подписка | $0.3/день за GPU  |

## Дополнительное чтение

* [Репозиторий на GitHub](https://github.com/ace-step/ACE-Step)
* [Узлы ComfyUI](https://github.com/ace-step/ComfyUI-ACE-Step)
* [Руководство по AudioCraft](/guides/guides_v2-ru/audio-i-golos/audiocraft-music.md) — для музыки только с инструментами


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clore.ai/guides/guides_v2-ru/generaciya-muzyki/ace-step.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.