소개
이 엔드포인트가 하는 일
믹스된 곡 하나를 스템 다섯 개로 나누고 각각을 별도의 WAV 파일로 돌려줍니다.
중요한 입력
입력은 audio_url 하나뿐입니다. 10분 이하의 MP3 또는 M4A 곡을 넣습니다.
받게 되는 것
오디오 에셋 다섯 개이며, 각각의 stem 필드에 vocals, instrumental, drums, bass, other 중 하나가 표시됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 오디오 |
| 출력 | 오디오 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 분리할 곡. MP3 업로드 또는 MP3·M4A 파일 직접 링크이며 10분 이하입니다. 1자 이상 |
요금
$0.108 / 곡
길이와 상관없이 곡당 정액이며 10분 이하의 곡까지 처리합니다. 스템 다섯 개가 모두 포함됩니다. 실패한 요청은 과금되지 않습니다.
활용 사례
프롬프트 가이드 및 실전 팁
소개
Mureka Stem Separation은 AI 음악 회사 Mureka의 스템 분리기입니다. 믹스가 끝난 곡을 주면 파트별로 나눠 돌려줍니다. 리드와 코러스 목소리가 한 트랙, 전체 반주가 한 트랙, 그리고 그 반주를 다시 드럼, 베이스, 나머지로 나눈 트랙입니다.
요청
{
"audio_url": "https://example.com/song.mp3"
}
곡은 MP3 또는 M4A 파일이어야 합니다. WAV, FLAC 등 다른 형식은 제출 단계에서 거부됩니다.
받게 되는 결과
작업은 스템마다 하나씩 오디오 에셋 다섯 개를 돌려주며 각각 stem 필드가 붙습니다.
| stem | 내용 |
|---|---|
vocals | 리드와 코러스 목소리 |
instrumental | 목소리를 뺀 전부 |
drums | 반주 중 타악기 |
bass | 반주 중 베이스 라인 |
other | 반주의 나머지: 기타, 건반, 패드, 효과음 |
모든 스템은 16비트, 44.1kHz 스테레오 WAV이며 길이가 곡과 정확히 같아서 어떤 편집 프로그램에서도 다섯 개가 첫 샘플부터 맞춰집니다.
테스트에서 확인한 것
60초짜리 보사노바 듀엣과 같은 곡의 30초 발췌본을 분리했습니다. 둘 다 약 10초 안에 끝났습니다. 드럼, 베이스, 기타를 더하면 반주와 샘플 단위로 일치했습니다. 반주만 나오는 구간에서 보컬 스템은 거의 무음으로 노래 부분보다 약 55dB 낮아, 밴드 소리가 거의 섞이지 않았습니다. 60초 WAV 하나는 약 10.6MB였습니다.
작업 흐름
호출은 비동기입니다. 작업을 만들고 끝날 때까지 폴링한 뒤 SpicyAPI 저장소에서 스템을 하나씩 내려받으세요. 실패한 요청은 과금되지 않습니다.
팁
- 가지고 있는 가장 좋은 음질의 파일로 시작하세요. 많이 압축된 MP3의 잡음은 모든 스템에 남습니다.
- 노래방 반주에는
instrumental을 쓰고, 드럼 소리를 바꿔 다시 믹스하려면vocals,bass,other를 쓰세요. - 스템은 비압축이라 3분짜리 곡이면 모두 합쳐 약 160MB의 오디오가 됩니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/stem-separation/audio-separation",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.

