ACE Step — Pro Pack на RunComfy

Генерация музыки с управлением по тегам, 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

Работает через RunComfy CLI

# Шаг 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 минуты — вместо этого объединяйте вызовы.

Маршрут 1: ACE Step text-to-audio (по умолчанию)

Модель: acestep-ai/ace-step/text-to-audio (или acestep-ai/ace-step-1.5/text-to-audio)

Схема (обе версии — одинаковая)

Стоимость: 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".
• Включайте BPM в теги когда важен темп.
• Тексты с маркерами секций: [Verse], [Chorus], [Bridge], [Outro]. Соблюдайте стабильный метр.
• Инструментальный вариант: "lyrics": "[inst]" или "[instrumental]". Дополнительно добавьте «no vocals» в теги.
• Многоязычный вокал: ACE Step 1.5 поддерживает 50+ языков. Пишите тексты на нужном языке; также укажите язык в тегах.
• Фиксируйте seed для воспроизводимости ("seed": 42); используйте -1 для вариаций.

Маршрут 2: ACE Step audio-inpaint

Модель: 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

• Совпадайте с окружающими тегами — если оригинал «indie pop, electric guitar, 120 BPM», то вставляемый сегмент должен разделять достаточно тегов.
• Используйте _relative_to: "end" для нацеливания на аутро/последние секунды без вычисления точных временных меток.

Маршрут 3: ACE Step audio-outpaint

Модель: 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.
• Не превышайте 4 минуты общей длины — если оригинал 3 минуты, можно добавить максимум 1 минуту суммарно.

ACE Step vs ElevenLabs Music

Коды завершения

Безопасность и конфиденциальность

• Устанавливайте только через проверенный пакетный менеджер.
• Хранение токена: runcomfy login записывает токен в ~/.config/runcomfy/token.json с правами 0600.
• Права на тексты: если пользователь предоставляет тексты, убедитесь в наличии прав на них.
• Допустимые исходящие эндпоинты: только model-api.runcomfy.net и *.runcomfy.com. Телеметрия отсутствует.