ElevenLabs AI Music Generation — Pro Pack на RunComfy

Генерируйте полноценные песни и инструментальные треки из текстового описания — студийное качество 44,1 кГц стерео, от 5 секунд до 5 минут, с построчным управлением структурой. ElevenLabs Music на RunComfy Model API, вызываемый через CLI runcomfy.

runcomfy.com · ElevenLabs Music model · Документация CLI

Установка скилла

npx skills add agentspace-so/runcomfy-agent-skills --skill elevenlabs-music-generation -g

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

# 1. Установка (один из вариантов — подробности в скилле runcomfy-cli)
npm i -g @runcomfy/cli                              # глобальная установка
npx -y @runcomfy/cli --version                      # без установки

# 2. Войдите в аккаунт
runcomfy login                                      # или в CI: export RUNCOMFY_TOKEN=<token>

# 3. Генерация музыки
runcomfy run elevenlabs/elevenlabs/music-generation \
  --input '{"prompt": "..."}' \
  --output-dir ./out

Когда использовать ElevenLabs Music

Сильная сторона ElevenLabs Music — структурированные песни с настоящим вокалом: принимает краткое описание стиля и тексты с маркерами секций, возвращает связный сведённый трек. Выбирайте для:

• Полноценных вокальных песен — структура куплет/припев, многоязычные тексты, стабильный метр
• Инструментальных бэков — force_instrumental: true для фоновой музыки, интро подкастов, игровых петель
• Коротких брендовых активов — джинглы, стингеры, заглавные темы (5–30 с)
• Длинных треков — до 5 минут в одном вызове
• Коммерческих проектов — результат подходит для коммерческого использования

Если нужны окружающие звуки или разовый звуковой эффект (гром, шаги) — это задача для sound effects, а не для музыки. ElevenLabs Music предназначен для песен и треков.

Эндпоинт и схема входных данных

Модель: elevenlabs/elevenlabs/music-generation

Результат: стерео 44,1 кГц. JSON-результат содержит URL сгенерированного аудио — CLI скачивает его в --output-dir.

Стоимость: ~$0,0083 за секунду сгенерированного аудио (30 с ≈ $0,25, 60 с ≈ $0,50, 5 мин ≈ $2,49). Стоимость масштабируется с music_length_ms, поэтому делайте черновики короткими, а финальную версию — длинной.

Как вызывать

Полноценная вокальная песня со структурой:

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, morning on the ridge. [Chorus] We rise, we strike, we never fade out. [Bridge] soft breakdown, just piano and voice. [Outro] full band, fade.",
    "music_length_ms": 60000
  }' \
  --output-dir ./out

Инструментальный фоновый бэк:

runcomfy run elevenlabs/elevenlabs/music-generation \
  --input '{
    "prompt": "Calm lo-fi hip-hop instrumental for a study playlist. Warm Rhodes piano, soft vinyl crackle, mellow boom-bap drums, 75 BPM. No vocals. Consistent loop-friendly groove throughout.",
    "music_length_ms": 90000,
    "force_instrumental": true
  }' \
  --output-dir ./out

Короткий брендовый джингл:

runcomfy run elevenlabs/elevenlabs/music-generation \
  --input '{
    "prompt": "5-second cheerful brand stinger, bright marimba and a single uplifting chord resolve, no vocals.",
    "music_length_ms": 5000,
    "force_instrumental": true
  }' \
  --output-dir ./out

Советы по промптингу

ElevenLabs Music читает одно поле prompt, которое содержит и описание стиля, и тексты. Структурируйте его правильно:

• Начните с краткого описания стиля: жанр, настроение, темп (BPM), ключевые инструменты, тип вокала.
• Затем тексты с маркерами секций: [Intro], [Verse], [Chorus], [Bridge], [Outro]. Добавляйте примерную длительность или количество тактов.
• Соблюдайте стабильный метр — чётное количество слогов в строке, чёткая схема рифмовки. Модель следует метру; небрежный метр даёт неловкую фразировку.
• Называйте ведущие инструменты — "electric guitar carries the chorus, drums sit back in the verse."
• Для инструментала: установите force_instrumental: true И добавьте «no vocals» в промпт.
• Многоязычный: пишите тексты на целевом языке; при необходимости аннотируйте акцент / язык.
• Избегайте противоречивых стилевых инструкций — «aggressive metal» + «soft lullaby» в одном промпте сбивают модель. Одно связное направление за вызов.
• Черновик коротко, финал длинно: проверяйте направление на 30–45 с черновике (music_length_ms: 35000) перед оплатой 5-минутного рендера.

Типовые паттерны

• Заглавная тема для видео: полное описание + тексты + структура [Intro]/[Verse]/[Chorus], music_length_ms соответствует длине видео
• Интро / аутро подкаста: force_instrumental: true, 10–20 с, «loop-friendly, clean ending»
• Фоновая петля для игры: force_instrumental: true, «seamless loop», 60–120 с, стабильный грув
• Многоязычный релиз (та же песня, разные языки): один вызов на язык, идентичное описание стиля, меняются только слова текста
• Итерация, затем финализация: черновик на music_length_ms: 35000 для фиксации жанра/темпа/структуры → финальный рендер на полной длине

Ограничения

• Одно поле prompt содержит всё (стиль + тексты). Отдельного параметра «lyrics» нет.
• 5 с – 5 мин за вызов (music_length_ms 5000–300000). Для более длинных произведений генерируйте секции и склеивайте внешне.
• Стоимость масштабируется с длительностью — 5-минутный рендер примерно в 10 раз дороже 30-секундного.
• force_instrumental — единственный переключатель вокала. Нельзя запросить конкретные голосовые идентичности или клонировать певца через этот эндпоинт.

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

Как это работает

Скилл вызывает runcomfy run elevenlabs/elevenlabs/music-generation с JSON-телом. CLI отправляет POST-запрос к RunComfy Model API, опрашивает статус запроса, получает результат и скачивает сгенерированный аудиофайл в --output-dir. Ctrl-C отменяет удалённый запрос до выхода.

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

• Устанавливайте только через проверенный пакетный менеджер. Используйте npm i -g @runcomfy/cli или npx -y @runcomfy/cli. Агенты не должны выполнять произвольные удалённые скрипты установки через shell.
• Хранение токена: runcomfy login записывает токен в ~/.config/runcomfy/token.json с правами 0600. Никогда не выводите токен в промпт, не логируйте и не сохраняйте в репозиторий.
• Граница ввода (shell injection): промпт передаётся как JSON-строка через --input. CLI не раскрывает содержимое в shell. Поверхности для shell-инъекции нет.
• Права на тексты: если пользователь предоставляет тексты, убедитесь, что у него есть права на них. Генерация музыки с защищёнными авторским правом текстами — ответственность оператора.
• Допустимые исходящие эндпоинты: только model-api.runcomfy.net и *.runcomfy.net / *.runcomfy.com. Телеметрия и callback-вызовы отсутствуют.