Четыре endpoint для создания и редактирования музыки с моделью ACE Step от StepFun-AI через RunComfy CLI: базовая генерация, fine-tune стиля и редактирование.
npx -y skills add agentspace-so/runcomfy-agent-skills --skill ace-step --agent claude-codeГенерация музыки с управлением по тегам, inpainting и outpainting с открытой моделью ACE Step от StepFun-AI. Четыре CLI-доступных эндпоинта, $0,0002–0,0003 за секунду аудио, до 4 минут за вызов.
runcomfy.com · ACE Step base · ACE Step 1.5 · Документация CLI
npx skills add agentspace-so/runcomfy-agent-skills --skill ace-step -g
# Шаг 1 — установка (один из вариантов)
npm i -g @runcomfy/cli # глобальная установка
npx -y @runcomfy/cli --version # без установки
# Шаг 2 — войдите в аккаунт
runcomfy login
# Шаг 3 — генерация
runcomfy run acestep-ai/ace-step/text-to-audio \
--input '{"tags": "..."}' \
--output-dir ./out
ACE Step 1.5 (text-to-audio) — acestep-ai/ace-step-1.5/text-to-audio
Последнее поколение ACE Step. Поддержка вокала на 50+ языках, улучшенная обработка структурированных текстов, та же схема что и у базовой версии. Немного дороже ($0,0003/с против $0,0002/с).
Выбирайте для: многоязычных текстов, вокальных треков высокого качества.
Избегайте для: бюджетных пакетных задач, где базовой версии достаточно.
ACE Step (text-to-audio) — acestep-ai/ace-step/text-to-audio (по умолчанию — дёшево и быстро)
Оригинальный ACE Step. Генерация по тегам, опциональные тексты, 5–240 с стерео. $0,0002/с — примерно в 27 раз дешевле ElevenLabs Music.
Выбирайте для: массовых черновиков, фоновой музыки, джинглов, игровых петель, бюджетной итерации.
Избегайте для: максимально отполированных коммерческих вокальных хуков.
ACE Step (audio-inpaint) — acestep-ai/ace-step/audio-inpaint
Регенерация временного диапазона внутри существующего трека (не на основе маски; использует start_time / end_time в секундах).
Выбирайте для: исправления плохого припева, замены бриджа, замены 20-секундного раздела без перерендеринга всей песни.
Избегайте для: правок не ограниченных временем.
ACE Step (audio-outpaint) — acestep-ai/ace-step/audio-outpaint
Расширение существующего трека в обоих направлениях — добавить интро до, аутро после, или оба.
Выбирайте для: удлинения 30-секундного черновика до 2-минутного кута, добавления fade-in, построения более длинной аранжировки вокруг существующего хука.
Избегайте для: расширения трека за 4 минуты — вместо этого объединяйте вызовы.
Модель: acestep-ai/ace-step/text-to-audio (или acestep-ai/ace-step-1.5/text-to-audio)
| Поле | Тип | Обязательно | По умолчанию | Примечания |
|---|---|---|---|---|
tags | string | да | — | Теги жанра / настроения / инструментов через запятую. Управляет композицией |
lyrics | string | нет | — | Вокальный контент. Используйте маркеры [Verse], [Chorus], [Bridge]. Для без вокала: [inst] |
duration | int | нет | 60 | Длина в секундах. 5–240 (макс. 4 мин за вызов) |
seed | int | нет | -1 | Воспроизводимость; -1 — случайный |
Стоимость: ACE Step $0,0002/с · ACE Step 1.5 $0,0003/с. 60 с ≈ $0,012 / $0,018; 240 с ≈ $0,048 / $0,072.
runcomfy run acestep-ai/ace-step/text-to-audio \
--input '{
"tags": "lo-fi hip-hop, mellow, vinyl crackle, rhodes piano, soft drums, 75 BPM",
"lyrics": "[inst]",
"duration": 90
}' \
--output-dir ./out
"lo-fi hip-hop, mellow, vinyl crackle, rhodes piano, 75 BPM" лучше, чем "chill music".[Verse], [Chorus], [Bridge], [Outro]. Соблюдайте стабильный метр."lyrics": "[inst]" или "[instrumental]". Дополнительно добавьте «no vocals» в теги."seed": 42); используйте -1 для вариаций.Модель: acestep-ai/ace-step/audio-inpaint
runcomfy run acestep-ai/ace-step/audio-inpaint \
--input '{
"audio": "https://your-cdn.example/original-track.mp3",
"tags": "indie pop, breakdown, piano only, soft, no drums",
"start_time": 20,
"end_time": 40,
"lyrics": "[inst]"
}' \
--output-dir ./out
_relative_to: "end" для нацеливания на аутро/последние секунды без вычисления точных временных меток.Модель: acestep-ai/ace-step/audio-outpaint
runcomfy run acestep-ai/ace-step/audio-outpaint \
--input '{
"audio": "https://your-cdn.example/hook-30s.mp3",
"tags": "indie pop, electric guitar, drums, build-up before chorus, fade outro",
"extend_before_duration": 30,
"extend_after_duration": 60,
"lyrics": "[inst]"
}' \
--output-dir ./out
extend_before_duration и extend_after_duration.| Параметр | ACE Step | ElevenLabs Music |
|---|---|---|
| Стоимость | $0,0002–0,0003/с | $0,0083/с (~27× дороже) |
| Лицензия | Открытые веса (Apache 2.0) | Коммерческая, hosted |
| Многоязычный вокал | 50+ языков (версия 1.5) | Хорошая многоязычная поддержка |
| Длительность/вызов | 240 с (4 мин) | 300 с (5 мин) |
| Inpaint / outpaint | Да (по временному диапазону) | Нет |
| Генерация по тегам | Да (tags — обязательное поле) | Стиль — часть свободного промпта |
| Лучше для | Бюджетные пакеты, черновики, inpaint/outpaint | Премиальные вокальные хуки, полированные коммерческие кута |
| Код | Значение |
|---|---|
| 0 | успех |
| 64 | неверные аргументы CLI |
| 65 | некорректный JSON / несоответствие схеме |
| 69 | ошибка 5xx на стороне сервиса |
| 75 | повторяемая ошибка: таймаут / 429 |
| 77 | не выполнен вход или токен отклонён |
runcomfy login записывает токен в ~/.config/runcomfy/token.json с правами 0600.model-api.runcomfy.net и *.runcomfy.com. Телеметрия отсутствует.