# ACE-Step Studio — база знаний

Проект для систематизации генерации музыки через **ACE-Step 1.5 XL** (`~/ace-step-1.5`).

## Структура

```
acestep-studio/
├── prompts/
│   └── captions.json       # caption-шаблоны по жанрам (англ.) — что даёт хороший результат
├── lyrics/
│   └── structure.json      # архив лириков по структурам (Verse/Chorus/Bridge)
├── logs/
│   └── generation_log.json # логи генераций: seed/genre→качество (оценивать)
├── scripts/                # ген-скрипты (копируются в ~/ace-step-1.5/)
└── README.md
```

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

1. Выбрать жанр → взять caption из `prompts/captions.json`
2. Взять структуру из `lyrics/structure.json`
3. Сгенерировать в `~/ace-step-1.5/` (XL checkpoint)
4. Оценить результат → записать в `logs/generation_log.json`
5. Улучшить caption → обновить `prompts/captions.json`

## Параметры XL (acestep-v15-xl-turbo)

- `device='cuda'` + `thinking=False` + `guidance_scale=1.0` (turbo НЕ поддерживает CFG!)
- `inference_steps=8`, `offload_to_cpu=True`
- WAV 48k стерео, ~22 сек/трек на RTX A2000 12GB
- caption — английский, lyrics — русский

## MEDIA: для WebUI

`MEDIA:/home/neo/workspace/...wav` — без пробела после `MEDIA:`.
Файл должен быть в workspace (ace-step-1.5/output не в allowlist — cp в workspace).