Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references

멀티스템 분리 API

한 곡을 선택한 스템으로 분리하세요. 멀티스템 분리 API는 vocals, drums, bass, piano, guitars와 no_multistem 잔여 트랙을 반환할 수 있습니다.

모델 특징
한 번에 최대 6개 스템 · 7가지 스플리터 엔진
적합한 용도
리믹스, 연습 트랙, 샘플링
입력
오디오 파일 URL
출력
분리된 스템 (mp3 / wav / flac …)
Input
0/1 file

MP3 / WAV / AAC / OGG

예시: ["vocals","drum","bass"]

기본값 auto

deep_extraction 또는 clear_cut

선택 사항

mp3, wav, flac, aac 또는 ogg

Result

이 모델로 만들 수 있는 것

이 모델로 구축하고 배포할 수 있는 실제 워크플로우와 프로덕션 활용 사례입니다.

보컬, 드럼, 베이스, 피아노, 기타 스템으로 분리된 곡

리믹스 도구용 멀티스템 분리 API

리믹스 편집기, 루프 라이브러리, 뮤지션 연습 앱, 크리에이터 워크플로를 위해 멀티스템 분리 API로 보컬, 드럼, 베이스, 피아노, 기타를 추출하세요. 앱이 하나의 소스 파일을 보내면 라벨이 부여된 여러 트랙을 받습니다. 멀티스템 분리 API는 스템마다 별도의 호출을 보내지 않게 해 줍니다. 그 덕분에 사용자가 한 번에 여러 파트를 필요로 할 때 곡 프로젝트를 더 쉽게 추적할 수 있습니다. 사용자가 묶음을 기대한다면 단일 스템 작업을 반복하는 것보다 멀티스템 분리 API가 적합합니다.

스템 분리하기
여러 스템 트랙을 만드는 단일 오디오 작업

여러 출력을 위한 멀티스템 분리 API

소스 트랙 하나를 보내고 제품에 필요한 스템만 선택하세요. 작업이 성공하면 멀티스템 분리 API는 선택된 스템 트랙과 no_multistem 잔여 트랙을 반환합니다. 그러면 편집자는 분리된 파트와 그 파트를 제거한 소스를 모두 얻습니다. 연습 앱은 선택한 파트를 음소거할 수 있고, 편집기는 각 출력을 별도 레인으로 드래그할 수 있습니다. 멀티스템 분리 API는 이 출력들을 하나의 task id 아래 묶어 프로젝트 이력을 유지합니다.

선택된 오디오 스템에 연동된 과금 견적

스템 단위 과금이 적용된 멀티스템 분리 API

처리 시간과 비용은 선택된 스템에 따라 늘어납니다. 1분짜리 곡에서 vocals와 drums를 선택하면 스템 분 기준으로 2분입니다. 현재 스템 분당 요금은 이 페이지의 가격표에서 확인하세요. 멀티스템 분리 API는 그 규칙을 가격과 문서 모두에 표시합니다.

가격

크레딧 기반 — 1 크레딧 = 0.001 USD. 성공한 생성에 대해서만 비용을 지불합니다.

첫 테스트 비용
$0.2200 credits

최저 등급 1회 생성(1 stem minute).

테스트 예산 가이드
크레딧 충전
$10
약 50회 테스트
$50
약 250회 테스트
$100
약 500회 테스트
모델카테고리가격
멀티스템 분리선택한 스템 단위
$0.2
200 credits · 1 stem minute

reApi를 선택해야 하는 이유

이 멀티스템 분리 API가 stem_list를 사용하는 이유

멀티스템 분리 API는 제품이 한 번의 오디오 작업에서 지원되는 여러 스템을 요청할 수 있게 합니다. 같은 파일을 반복해서 돌리는 것보다 깔끔합니다. 작업 이력도 하나의 소스 트랙에 묶입니다.

반환되는 모든 파일에 라벨

output.tracks를 사용해 vocals, drum, bass, piano, electric_guitar, acoustic_guitar, no_multistem 라벨을 올바른 UI 슬롯이나 스토리지 경로에 매핑하세요. 특히 여러 작업이 동시에 완료될 때, 멀티스템 분리 API의 라벨은 파일명으로 추측하는 것보다 훨씬 다루기 쉽습니다. 사용자가 프로젝트를 다시 열거나, 내보내기 이름을 바꾸거나, 묶음을 공유하거나, 버전을 비교하거나, 며칠 뒤 스템을 다운로드할 수 있다면 그 매핑을 데이터베이스에 보관하세요. 공유 워크스페이스와 내보내기를 다루는 팀에 중요합니다.

멀티스템 분리 API의 stem_list 가드레일

playground는 제출 전에 stem_list를 검증합니다. 값은 1~6개이며 지원되지 않는 스템 이름은 허용되지 않습니다. 멀티스템 분리 API 문서는 백엔드 호출에도 동일한 계약을 적용합니다. 그래서 처리 단계에 도달하기 전에 흔한 잘못된 요청을 차단할 수 있습니다. 동일한 검증을 서버 측에도 두어 직접 API를 호출하는 측에도 같은 동작을 제공하세요.

3단계로 멀티스템 분리 API 통합하기

  1. step 01

    API 키 발급

    워크스페이스 설정에서 reAPI 키를 생성하고 오디오 생성 엔드포인트로의 백엔드 호출에 사용하세요.

    열기
  2. step 02

    멀티스템 작업 제출

    model을 audio-multistem으로 지정하고 공개 audio_url과 stem_list 배열을 함께 POST 요청하세요. 제품에 실제로 필요한 스템만 선택하세요.

    열기
  3. step 03

    폴링 후 라벨 매핑

    작업이 완료될 때까지 GET /api/v1/tasks/:id를 호출하세요. 다운로드에는 output.audio_urls를 사용하고, 선택된 각 스템과 no_multistem 매핑에는 output.tracks를 사용하세요.

    열기
docs/api/multistem-splitter

API 레퍼런스

바로 사용 가능한 코드와 전체 파라미터 표입니다.

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"audio-multistem","audio_url":"https://cdn.example.com/song.wav","stem_list":["vocals","drum","bass"],"encoder_format":"mp3"}'

파라미터 검증 실패

제출 시 동기적으로 거부되며 문제 필드가 명시됩니다. 열거 값·범위·URL 필드를 확인하세요. 과금은 발생하지 않습니다.

인증 또는 잔액 문제

401은 Bearer 키 누락/무효, 402는 선차감액이 잔액을 초과함을 뜻합니다. 키와 크레딧은 콘솔에서 관리합니다.

콘텐츠 또는 소재 거부

참조 소재와 생성 결과는 자동 심사를 거칩니다. 거부된 작업은 명확한 오류와 함께 실패하고 전액 환불됩니다.

작업 실패 또는 시간 초과

실패 상태에 도달한 작업은 과금되지 않으며 선차감액이 자동 환불됩니다. 작업 ID를 보관했다가 재시도하세요.

자주 묻는 질문

이 모델에 대한 일반적인 질문입니다.

멀티스템 분리 API는 하나의 소스 파일에서 선택된 여러 스템을 추출하기 위한 비동기 오디오 스템 분리 API입니다. audio_url과 stem_list를 전송한 다음, 작업이 완료될 때 라벨이 부여된 출력을 폴링하세요. 하나의 파일에 여러 분리된 파트가 필요할 때 멀티스템 분리 API를 사용하세요.

start building

이제 출시할 준비가 되셨나요?

Playground에서 시험해 보거나 API 키를 발급받아 바로 연동해 보세요.