ai-musicмаршрутизатор генерации музыки
Маршрутизирует запросы музыкальной генерации между ElevenLabs (44.1kHz студийное) и ACE Step (open-weights): выбор по качеству и типу контента.
Установка
npx -y skills add agentspace-so/runcomfy-agent-skills --skill ai-music --agent claude-codeAI Music
Генерируйте AI-музыку на RunComfy через один CLI — вокальные песни, инструментальные треки, джинглы, игровые петли, многоязычные каверы. Этот скилл выбирает нужную модель из каталога RunComfy исходя из реального намерения пользователя и поставляет задокументированные паттерны промптинга + точный вызов runcomfy run для каждой.
runcomfy.com · Аудиомодели · Документация CLI
Установка скилла
npx skills add agentspace-so/runcomfy-agent-skills --skill ai-music -g
Работает через RunComfy CLI
# Шаг 1 — установка
npm i -g @runcomfy/cli # глобальная установка
npx -y @runcomfy/cli --version # без установки
# Шаг 2 — войдите в аккаунт
runcomfy login
# Шаг 3 — генерация музыки
runcomfy run <vendor>/<model>/<endpoint> \
--input '{"prompt": "...", ...}' \
--output-dir ./out
Выбор модели под намерение пользователя
Text-to-music (генерация с нуля) — от новейшей
ACE Step 1.5 — acestep-ai/ace-step-1.5/text-to-audio
Последнее поколение ACE Step. Поддержка вокала на 50+ языках, улучшенная обработка структурированных текстов, $0,0003/с. Открытые веса (Apache 2.0).
Выбирайте для: многоязычных запусков, вокальных песен не на английском, hero-качества ACE.
ElevenLabs AI Music Generation — elevenlabs/elevenlabs/music-generation
Премиальное 44,1 кГц стерео, 5 с–5 мин, секционный контроль структуры, многоязычный вокал, коммерческое использование. $0,0083/с (~27× ACE Step).
Выбирайте для: hero-брендовых кампаний, полированных вокальных хуков, рекламной музыки.
Избегайте для: массовых черновиков / библиотек фоновой музыки.
ACE Step (base) — acestep-ai/ace-step/text-to-audio (по умолчанию для бюджетных задач)
Оригинальный ACE Step. Генерация по тегам, опциональные тексты, 5–240 с. $0,0002/с — самая дешёвая CLI-доступная музыкальная модель на RunComfy.
Выбирайте для: библиотек фоновой музыки, джинглов, игровых петель, черновиков.
Избегайте для: премиальных вокальных хуков.
Редактирование существующего аудио — только ACE Step
ACE Step audio-inpaint — acestep-ai/ace-step/audio-inpaint
Регенерация временного диапазона внутри существующего трека.
Выбирайте для: исправления плохого припева, замены бриджа, замены секции без перерендеринга.
ACE Step audio-outpaint — acestep-ai/ace-step/audio-outpaint
Расширение трека в обоих направлениях (extend_before_duration / extend_after_duration).
Выбирайте для: удлинения 30-секундного хука до 2-минутного кута.
Маршрут 1: ElevenLabs AI Music Generation — премиум
runcomfy run elevenlabs/elevenlabs/music-generation \
--input '{
"prompt": "Upbeat indie-pop anthem, bright electric guitars, driving drums, 120 BPM, female lead vocal. [Intro 8 bars] instrumental build. [Verse] Chalk on the palms, laces double-knotted. [Chorus] We rise, we strike, we never fade out. [Outro] full band, fade.",
"music_length_ms": 60000
}' \
--output-dir ./out
ElevenLabs Music читает один промпт со стилевым описанием и текстами с маркерами секций. force_instrumental: true для без вокала. $0,0083/с — делайте короткие черновики, финализируйте длинные.
Маршрут 2: ACE Step / ACE Step 1.5 — дёшево, открытые веса
runcomfy run acestep-ai/ace-step-1.5/text-to-audio \
--input '{
"tags": "indie pop, anthemic, electric guitar, driving drums, female vocal, 120 BPM",
"lyrics": "[Verse]\nChalk on the palms\nMorning on the ridge\n[Chorus]\nWe rise, we strike, we never fade out",
"duration": 60
}' \
--output-dir ./out
ACE Step разделяет стиль в tags и вокальный контент в lyrics (маркеры секций или [inst] для инструментала). Версия 1.5 добавляет поддержку 50+ языков.
Маршрут 3: ACE Step audio-inpaint — починка секции
runcomfy run acestep-ai/ace-step/audio-inpaint \
--input '{
"audio": "https://your-cdn.example/song.mp3",
"tags": "indie pop, breakdown, piano only, soft, no drums",
"start_time": 20,
"end_time": 40,
"lyrics": "[inst]"
}' \
--output-dir ./out
start_time_relative_to и end_time_relative_to по умолчанию start; задайте end для привязки к концу трека без вычисления точных временных меток.
Маршрут 4: ACE Step audio-outpaint — расширение трека
runcomfy run acestep-ai/ace-step/audio-outpaint \
--input '{
"audio": "https://your-cdn.example/hook-30s.mp3",
"tags": "indie pop, build-up before chorus, fade outro",
"extend_before_duration": 30,
"extend_after_duration": 60,
"lyrics": "[inst]"
}' \
--output-dir ./out
Типовые паттерны
- Джингл для премиальной брендовой кампании (5–15 с): маршрут 1 (ElevenLabs Music) — hero-качество. $0,05–0,12 за дубль.
- Библиотека фоновой музыки (50+ треков): маршрут 2 (ACE Step base) с разными тегами. $0,012/60 с × 50 = $0,60 за 50 черновиков.
- Многоязычный запуск (та же песня, 8 языков): маршрут 2 (ACE Step 1.5) — идентичные теги, меняются только тексты. Или маршрут 1 если важно премиальное качество.
- Фоновая петля для игры: маршрут 2 (ACE Step base) с «seamless loop, consistent groove», 60–120 с.
- «Есть 30-секундный хук, нужен 2-минутный трек»: маршрут 4 (ACE Step audio-outpaint) — добавьте 30 с интро + 60 с аутро за один вызов.
- «Второй припев вышел плохо»: маршрут 3 (ACE Step audio-inpaint) с
start_time/end_timeвокруг плохого припева. - Дешёвый черновик → полированный финал: итерируйте теги на маршруте 2 (ACE Step base) по $0,01–0,02 за попытку → зафиксируйте вайб → финальный рендер на маршруте 1 (ElevenLabs Music).
Дерево решений для агента
- Генерация с нуля или редактирование существующего аудио?
- Редактирование → шаг 5
- Генерация → шаг 2
- Нужно премиальное качество (бренд / коммерция)?
- Да → маршрут 1 (ElevenLabs Music)
- Нет → шаг 3
- Нужен многоязычный вокал?
- Да → маршрут 2 (ACE Step 1.5)
- Нет → шаг 4
- Бюджетный пакет или одиночный трек?
- Бюджет / пакет → маршрут 2 (ACE Step base)
- Одиночный → маршрут 1 или 2 в зависимости от бюджета
- Тип редактирования?
- Переписать ограниченную секцию → маршрут 3 (audio-inpaint)
- Добавить до / после → маршрут 4 (audio-outpaint)
Коды завершения
| Код | Значение |
|---|---|
| 0 | успех |
| 64 | неверные аргументы CLI |
| 65 | некорректный JSON / несоответствие схеме |
| 69 | ошибка 5xx на стороне сервиса |
| 75 | повторяемая ошибка: таймаут / 429 |
| 77 | не выполнен вход или токен отклонён |
Безопасность и конфиденциальность
- Устанавливайте только через проверенный пакетный менеджер.
- Хранение токена:
runcomfy login→~/.config/runcomfy/token.json, права 0600. - Права на тексты: при предоставлении текстов убедитесь в наличии прав.
- Допустимые исходящие эндпоинты: только
model-api.runcomfy.netи*.runcomfy.com. Телеметрия отсутствует.
