elevenlabs-music

개요

elevenlabs-music란?

elevenlabs-music는 커맨드라인 환경에 최적화된 AI 음악 생성 스킬로, inference.sh (infsh) CLI를 통해 여러분의 에이전트나 터미널 워크플로를 ElevenLabs 음악 모델과 연결해 줍니다.

짧은 텍스트 프롬프트만으로도 프로젝트에 딱 맞는 오리지널 로열티 프리 음악을 만들 수 있습니다. 이 스킬은 inference.sh의 elevenlabs/music 앱을 감싸는 래퍼 역할을 하며, 다음과 같은 작업을 할 수 있습니다:

• 텍스트 설명을 음악으로 변환 (text-to-music)
• 5초부터 10분까지 트랙 길이 제어
• 프롬프트로 장르, 분위기, 악기 구성까지 조정
• 영상, 팟캐스트, 게임 등 상업적 활용이 가능한 오디오 제작

이 스킬은 누구를 위한 것인가요?

elevenlabs-music는 다음과 같은 사용자를 위해 설계되었습니다:

• 크리에이터 및 편집자: YouTube, TikTok, 라이브 스트리밍, 팟캐스트, 트레일러용 맞춤 배경 음악이 빠르게 필요한 사람
• 게임·앱 개발자: 레벨, 메뉴, 인앱 경험에 맞춰 필요할 때마다 바로 생성되는 적응형 음악 베드를 원하는 사람
• 마케터 및 브랜드 팀: 버전마다 작곡가를 섭외하지 않고도 광고용 징글, 짧은 큐, 브랜디드 음악을 다양하게 만들고 싶은 팀
• 개발자 및 에이전트 빌더: 스크립트, 자동화, AI 에이전트 안에서 예측 가능한 CLI/API 스타일 인터페이스로 음악을 생성하고 싶은 사람

이미 inference.sh를 사용 중이거나 CLI 기반 도구로 워크플로를 구성하고 있다면, elevenlabs-music는 자연스럽게 기존 스택에 녹아듭니다.

elevenlabs-music는 어떤 문제를 해결하나요?

다음과 같은 상황에서 특히 유용합니다:

• 빠른 로열티 프리 음악이 필요하지만 스톡 라이브러리를 뒤질 시간이 없을 때
• 일관된 스타일의 트랙을 반복적으로 만들어야 할 때 (예: 시리즈용 비슷한 분위기의 여러 곡)
• 자동화 친화적인 오디오 생성이 필요할 때 — 에이전트나 스크립트가 사용자 입력이나 콘텐츠 메타데이터에 따라 음악을 자동 생성

infsh app run elevenlabs/music 방식으로 동작하므로, 별도의 API 레이어를 만들지 않고도 셸 스크립트, CI 파이프라인, 채팅 기반 에이전트 등에 바로 통합할 수 있습니다.

언제 elevenlabs-music를 쓰는 게 좋을까요?

다음에 해당한다면 elevenlabs-music 사용을 추천합니다:

• 기본적인 CLI 명령어나 CLI를 호출하는 에이전트 도구에 익숙하다
• 보컬 중심의 완곡보다는 배경 음악, 앰비언스, 간단한 효과음/큐를 위주로 만들고 싶다
• 빠른 반복 작업이 필요하다: 여러 프롬프트와 길이를 시험해 보며 적합한 트랙을 찾고 싶다

반대로 다음에 해당한다면 적합하지 않을 수 있습니다:

• 마디, 템포 맵, 코드 진행 등을 코드로 세밀하게 제어하는 정교한 편곡/작곡이 필요할 때
• 보컬 퍼포먼스, 가사 싱크, 멀티 스템(드럼/베이스/보컬 분리) 등의 기능이 필요할 때
• inference.sh CLI를 전혀 사용하고 싶지 않을 때 — 이 스킬은 infsh에 의존합니다.

사용 방법

1. 준비 사항 및 설치

환경 확인하기

elevenlabs-music를 사용하기 전에 다음을 준비해 주세요:

• inference.sh CLI (infsh)를 설치하고 실행할 수 있는 시스템
• infsh가 ElevenLabs 기반의 elevenlabs/music 앱을 호출할 수 있는 네트워크 연결

에이전트 환경에 스킬 설치하기

inferen-sh/skills 레포에서 제공하는 스킬 로더를 사용 중이라면, 다음 명령으로 elevenlabs-music를 설치합니다:

npx skills add https://github.com/inferen-sh/skills --skill elevenlabs-music

이 명령은 레포에서 스킬 정의를 가져와 에이전트 도구에서 사용할 수 있도록 등록합니다.

inference.sh CLI 설치하기

elevenlabs-music는 infsh CLI에 의존합니다. 레포의 공식 설치 가이드를 따라 설치하세요:

• CLI 설치 가이드: https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

설치 후 제대로 동작하는지 확인합니다:

infsh --help

도움말 텍스트가 출력되면 CLI 준비가 완료된 것입니다.

2. inference.sh에 로그인

음악을 생성하기 전에 CLI 세션을 인증합니다:

infsh login

화면에 나오는 인터랙티브 안내에 따라 로그인하면 됩니다. 이 과정에서 infsh가 inference.sh 계정과 연결되며, elevenlabs/music 앱에 접근할 수 있게 됩니다.

3. 첫 번째 AI 음악 트랙 생성하기

기본 text-to-music 명령

로그인 후에는 간단한 프롬프트로 바로 음악을 생성할 수 있습니다:

infsh app run elevenlabs/music --input '{"prompt": "Upbeat electronic dance track with driving synths"}'

이 명령은 여러분이 작성한 설명을 inference.sh를 통해 ElevenLabs 음악 모델로 전송합니다. 출력 결과는 생성된 오디오에 대한 참조(예: URL, 파일 메타데이터 등)를 담은 JSON이며, 이는 CLI 설정에 따라 달라질 수 있습니다.

4. 길이와 스타일 제어하기

elevenlabs-music 스킬은 기반 앱의 파라미터를 노출해 결과를 세밀하게 조정할 수 있게 해줍니다.

사용 가능한 파라미터

• prompt (string, 필수)
  • 원하는 음악을 설명하는 자연어 텍스트 (최대 2000자).
  • 가능하면 장르, 분위기, 템포, 사용하고 싶은 악기를 함께 적어 주세요.
• duration_seconds (number, 선택)
  • 기본값: 30
  • 최소: 5, 최대: 600 (최대 10분)

사용 예시

예시: 짧은 로고/인트로 스팅 (10초)

infsh app run elevenlabs/music --input '{
  "prompt": "Short cinematic logo sting with orchestral hit and subtle whoosh",
  "duration_seconds": 10
}'

예시: 2분짜리 lo-fi 공부용 비트

infsh app run elevenlabs/music --input '{
  "prompt": "Lo-fi hip hop beat, chill study music, vinyl crackle, mellow piano",
  "duration_seconds": 120
}'

이런 방식으로 인트로, 짧은 효과음(stinger), 긴 배경 음악 등 목적에 맞게 길이를 조절할 수 있습니다.

5. 출력 결과 해석하기

ElevenLabs 음악 생성은 inference.sh 앱 환경 안에서 실행되며, 결과로 JSON 출력을 반환합니다. 구조는 시간이 지나며 변경될 수 있지만, 일반적으로 생성된 오디오를 가리키는 키(예: 렌더링된 파일의 URL, inference.sh 내부 ID 등)를 포함합니다.

보통 다음과 같은 후속 작업을 수행하게 됩니다:

• 스크립트나 에이전트 안에서 JSON을 파싱
• 오디오 파일을 다운로드해 DAW, 영상 편집기, 팟캐스트 편집 도구 등에서 사용
• 프롬프트, 길이, 생성 시각 등의 메타데이터를 미디어 자산과 함께 저장해 재생성이나 문서화에 활용

6. 에이전트와 워크플로에서 elevenlabs-music 활용하기

이 스킬은 inferen-sh/skills 레포지토리 내에 정의되어 있으며 **Bash와 infsh**를 사용하도록 설정되어 있습니다. 따라서 에이전트는 다음과 같은 방식으로 활용할 수 있습니다:

• 사용자가 “영상 인트로용 배경 음악 만들어줘”와 같은 의도를 보이면 infsh app run elevenlabs/music를 호출
• 사용자 지시에 따라 동적으로 prompt와 duration_seconds 값을 구성
• 생성된 음악 링크나 파일 참조를 사용자 또는 후속 도구에 전달

이를 통해 elevenlabs-music는 다음과 같은 시나리오에 유용합니다:

• 멀티스텝 콘텐츠 파이프라인 (예: 스크립트 생성 → 이미지 생성 → 음악 생성)
• 요청 시 맞춤 사운드트랙을 제공하는 채팅형 크리에이티브 어시스턴트

7. 확인해 볼 파일과 설정

스킬 설치 후 동작 방식을 이해하거나 커스터마이즈하려면, inferen-sh/skills 레포에서 다음 파일을 살펴보세요:

• SKILL.md (이 스킬의 루트 문서): 개요 설명과 빠른 시작용 명령
• tools/audio/elevenlabs-music/ (클론한 레포에 존재하는 경우): 구현 세부 사항 및 헬퍼 스크립트

이 파일들은 스킬이 CLI와 어떻게 연동되는지, 그리고 변경 사항이나 업데이트 내용을 설명합니다.

자주 묻는 질문(FAQ)

elevenlabs-music는 무료인가요?

elevenlabs-music 자체는 inference.sh를 통해 elevenlabs/music 앱에 연결해 주는 스킬 정의입니다. 이용 요금과 제한은 이 스킬이 아니라 여러분의 inference.sh 및 ElevenLabs 설정에 따라 결정됩니다.

대량 사용 전에는 inference.sh 계정과 ElevenLabs 요금제에서 가격, 쿼터, 호출 제한을 꼭 확인하세요.

elevenlabs-music로 어떤 종류의 음악을 만들 수 있나요?

기반 ElevenLabs 모델은 자연어 프롬프트 기반의 연주·배경 음악 트랙에 최적화되어 있습니다. 다음과 같이 설명할 수 있습니다:

• 장르: lo-fi, EDM, cinematic, ambient, rock, orchestral 등
• 분위기: upbeat, dark, suspenseful, relaxing, uplifting 등
• 용도: 공부용 음악, 트레일러 스코어, 게임 레벨 테마, 팟캐스트 인트로, 광고 배경음 등

(분위기 + 장르 + 악기 + 사용 맥락)을 조합한 구체적인 프롬프트를 사용할수록 결과가 좋아집니다.

생성 가능한 트랙 길이는 어느 정도인가요?

duration_seconds를 5초부터 600초(10분) 사이로 설정할 수 있습니다:

• 최소: 5
• 최대: 600 (10분)

이 파라미터를 생략하면 기본값은 30초입니다.

음악 길이를 변경하려면 어떻게 하나요?

--input에 전달하는 JSON 안에 duration_seconds를 포함하세요:

infsh app run elevenlabs/music --input '{
  "prompt": "Epic orchestral battle music",
  "duration_seconds": 300
}'

5–600초 범위 안에서 원하는 길이로 숫자를 조정하면 됩니다.

elevenlabs-music로 만든 트랙을 상업적으로 사용할 수 있나요?

SKILL 설명에는 inference.sh를 통한 ElevenLabs AI 음악 생성이 로열티 프리 상업적 활용을 지원한다고 명시되어 있습니다. 다만, 정책은 변경될 수 있으므로 ElevenLabs와 inference.sh의 최신 약관 및 라이선스를 직접 확인하는 것이 안전합니다.

elevenlabs-music를 쓰려면 코드를 직접 작성해야 하나요?

별도의 애플리케이션 코드를 꼭 작성할 필요는 없지만, 다음 정도에는 익숙한 편이 좋습니다:

• 터미널에서 명령어 실행하기
• --input 플래그를 통해 JSON 입력 전달하기

웹 앱이나 에이전트 플랫폼과 깊이 통합하려면, 보통 코드에서 infsh를 쉘 아웃으로 호출하거나, 에이전트 프레임워크가 제공하는 CLI 호출 메커니즘을 사용하게 됩니다.

elevenlabs-music는 보이스나 가사를 지원하나요?

이 스킬은 텍스트 프롬프트 기반 음악 생성에 초점을 두고 있으며, 가사 싱크나 보컬 퍼포먼스 생성까지는 다루지 않습니다. 프롬프트에 “choir pads”, “vocal chops”처럼 보컬 느낌의 사운드를 묘사할 수는 있지만, 구체적인 가사-멜로디 정렬은 이 스킬의 공식 지원 범위를 벗어납니다.

더 자세한 정보나 업데이트는 어디에서 볼 수 있나요?

inferen-sh/skills 레포지토리에서 이 스킬 정보를 확인할 수 있습니다:

• Repo: https://github.com/inferen-sh/skills
• Skill path: tools/audio/elevenlabs-music

최신 예제, 파라미터, CLI 사용 팁은 SKILL.md와 관련 파일을 참고하세요. CLI나 앱 이름이 변경될 경우에도 보통 이 파일들이 가장 먼저 업데이트됩니다.