음악
Mureka로 AI 음악을 생성, 리믹스, 확장, 분석합니다 — 노래, 인스트루멘털, 사운드트랙, 스템, 가사.
프롬프트나 가사로 오리지널 AI 음악을 만들고, 기존 곡을 리믹스하고, 이미지나 영상에 음악을 붙이고, 특정 트랙만 분리하고, 오디오를 분석합니다 — 모두 listenhub music CLI를 통해 Mureka 제공자가 처리합니다.
트리거
/music으로 이 skill을 호출하거나, 다음 문구 중 아무거나 사용하세요:
| 문구 | 언어 |
|---|---|
music / generate music / compose | 영어 |
create a song / cover / remix | 영어 |
instrumental / soundtrack / stem | 영어 |
recognize lyrics / extend | 영어 |
音乐 / 生成音乐 / 作曲 / 做一首歌 | 중국어 |
翻唱 / 混音 / 续写 / 纯音乐 | 중국어 |
配乐 / 分轨 / 识别歌词 | 중국어 |
ListenHub Skills가 설치되어 있어야 합니다 — 시작하기를 참고하세요.
이 skill은 화자를 쓰지 않습니다 — 음악 생성에는 화자 선택이 없습니다.
빠른 예시
Make a song about a summer evening by the seaAI가 어떤 기능을 쓸지와 파라미터를 함께 확인한 뒤 작업을 제출하고, 트랙이 완성되면 알려 줍니다. 듣기 링크, 길이, 크레딧 비용을 받게 되며, 출력 모드가 download나 both로 설정되어 있으면 로컬 다운로드까지 받습니다.
기능
이 skill의 명령은 두 갈래로 나뉩니다: 생성(generation) 명령은 비동기로 실행되어 폴링할 작업을 반환하고, 분석(analysis) 명령은 동기로 실행되어 같은 호출에서 결과를 돌려줍니다.
generate — 텍스트와 가사(둘 중 하나 또는 둘 다)로 새 곡을 만듭니다. prompt나 lyrics 중 최소 하나는 필수입니다. 선택 항목으로 style, title, model, 인스트루멘털 토글, 클로닝된 vocal-id가 있습니다. 비동기.
remix — 기존 곡에 새 가사를 얹어 다시 만듭니다. 입력 소스는 정확히 하나만 주세요: 오디오 파일, 오디오 URL, 또는 Mureka provider-song-id. lyrics와 prompt는 둘 다 필수입니다. 선택 항목은 style, title, model. 비동기.
instrumental — 보컬이 없는 순수 인스트루멘털입니다. prompt나 reference-audio 파일 중 정확히 하나를 주세요. 선택 항목은 title, model. 비동기.
soundtrack — 이미지나 영상에 맞춰 붙이는 음악입니다. image나 video 중 정확히 하나를 주세요. 선택 항목은 prompt, title, model. 비동기.
track — 곡에서 악기나 보컬 트랙 하나를 분리하거나 생성합니다. 입력 소스 하나(오디오 파일 또는 provider-song-id)와 generate-type을 함께 주세요. 타입이 Vocals이면 lyrics가 필수입니다. 선택 항목으로 prompt, vocal-gender, 초 단위의 generate-start/generate-end 구간이 있습니다. 비동기.
extend — 기존 곡을 더 길게 늘립니다. 입력 소스 하나(오디오 파일 또는 provider-song-id)를 주세요. 선택 항목으로 어떻게 이어 갈지 설명하는 prompt와 model이 있습니다. 비동기.
recognize — 오디오 파일에서 줄 단위 타임스탬프가 붙은 가사를 추출합니다. 동기 — 결과가 바로 돌아옵니다.
describe — 오디오 파일을 분석해 설명, 태그, 장르, 악기를 뽑아냅니다. 동기 — 결과가 바로 돌아옵니다.
stem — 곡을 분리된 스템으로 나누고 ZIP 다운로드 URL을 반환합니다. 분리 모델(audio-separation-1 또는 audio-separation-2)을 고르세요. 동기 — 결과가 바로 돌아옵니다.
cover 기능도 있지만 더 이상 권장되지 않습니다 — 예전 cover 흐름이 꼭 필요한 경우가 아니라면 remix를 쓰세요.
작업 관리 명령 두 개는 언제든 쓸 수 있습니다: list는 최근 작업을 보여 주고, get <taskId>는 작업 하나의 상태나 결과를 반환합니다.
모델
생성 명령은 model 파라미터를 받습니다. 기본값은 auto이며, 서비스가 알아서 고릅니다.
| 모델 | 비고 |
|---|---|
auto | 기본값 — 서비스가 모델을 선택 |
mureka-7.6 | Mureka 7.6 |
mureka-8 | Mureka 8 |
mureka-9 | Mureka 9 |
mureka-o2 | Mureka o2 |
분석은 다릅니다. stem 명령은 대신 분리 모델 — audio-separation-1 또는 audio-separation-2 — 을 받습니다. recognize와 describe 명령은 모델을 받지 않습니다.
파라미터
파라미터는 기능마다 다르게 적용됩니다. 각 명령에 필요한 것만 주면 됩니다. AI가 필수 입력을 물어보고 선택 항목을 제안합니다.
| 파라미터 | 적용 대상 | 비고 |
|---|---|---|
prompt | generate, remix, instrumental, soundtrack, track, extend | 음악이나 방향을 설명하는 자유 텍스트 |
lyrics | generate, remix, track(Vocals일 때만) | 노래 가사 |
style | generate, remix | 장르나 분위기, 예: city pop |
title | generate, remix, instrumental, soundtrack | 트랙 제목, 생략하면 자동 생성 |
model | 생성 명령 | 위 모델 중 하나, 기본값은 auto |
instrumental | generate | 보컬 끄기 |
vocal-id | generate | 클로닝된 보이스 id |
audio / audio-url / provider-song-id | remix, track, extend | 입력 곡, 정확히 하나만 지정 |
reference-audio | instrumental | 참조 오디오 파일(prompt 대신 사용) |
image / video | soundtrack | 소스 미디어, 정확히 하나만 지정 |
generate-type | track | Vocals, Instrumental, Drums, Bass, Guitar, Keyboard, Percussion, Strings, Synth, FX, Brass, Woodwinds 중 하나 |
vocal-gender | track | male 또는 female |
generate-start / generate-end | track | 초 단위 시간 구간 |
파일 제한
모든 입력 파일은 10 MB로 제한됩니다. 유형별로 지원하는 포맷은 다음과 같습니다:
| 유형 | 포맷 |
|---|---|
| 오디오 | mp3, m4a(track 명령은 wav도 지원) |
| 이미지 | jpg, jpeg, png, webp |
| 영상 | mp4, mov, avi, mkv, webm |
명령이 지원하는 경우에는 로컬 파일 대신 URL을 넘겨도 됩니다. CLI가 제출 시점에 검증합니다.
음악 생성은 느립니다 — 트랙당 대략 5~10분을 예상하세요. AI가 백그라운드로 작업을 제출하고 완료되면 알려 줍니다. 작업 id만 가지고 있다면 listenhub music get <taskId> --json으로 진행 상황을 확인하거나 listenhub music list --json으로 목록을 훑어보세요.
출력
출력 동작은 설정에서 지정한 outputMode를 따릅니다:
inline또는both— 오디오 URL이 클릭할 수 있는 듣기 링크로 표시되고, 제목·길이·크레딧 비용이 함께 나옵니다.download또는both— 파일이 현재 작업 디렉터리에도 주제를 딴 알아보기 쉬운 이름으로 저장됩니다(예:summer-breeze.mp3). 이름 중복은 자동으로 처리됩니다.
stem의 결과는 하나 이상의 ZIP 다운로드 URL이며, download나 both 모드에서는 현재 디렉터리로 내려받습니다. recognize와 describe의 결과는 대화 안에 바로 표시됩니다.
완료된 작업마다 creditCost가 보고됩니다. 크레딧을 추정하거나 확인하려면 음악 API 레퍼런스의 크레딧 안내를, 잔액은 GET /v1/user/subscription을 참고하세요.
CLI 명령
이 skill은 listenhub music 명령 그룹을 사용합니다. 기본 형태는 다음과 같습니다:
# Generate a song (async — polls until ready)
listenhub music generate --prompt "upbeat summer pop about the sea" --json
# Remix an existing file with new lyrics
listenhub music remix --audio demo.mp3 --lyrics "..." --prompt "rework as city pop" --json
# Pure instrumental
listenhub music instrumental --prompt "electronic track for a game intro" --json
# Soundtrack for a video
listenhub music soundtrack --video clip.mp4 --prompt "tense, suspenseful score" --json
# Analyze audio (sync)
listenhub music recognize --audio song.mp3 --json
listenhub music describe --audio song.mp3 --json
listenhub music stem --audio track.mp3 --model audio-separation-2 --json
# Task management
listenhub music list --json
listenhub music get <taskId> --json전역 플래그도 그대로 적용됩니다: 기계용 출력은 --json / -j, 폴링을 건너뛰려면 --no-wait, 대기 시간을 제한하려면 --timeout <s>.
API 레퍼런스
엔드포인트 경로, 요청 파라미터, 응답 필드, 크레딧 처리 방식은 음악 API 레퍼런스를 참고하세요.