소개
기존 녹음을 한 번의 요청으로 보컬과 배경 오디오로 분리하세요. 두 스템을 음악 연습, 내레이션 편집 또는 새로운 믹스에 활용할 수 있어요.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 오디오 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
audio_url | 예 | 분리할 믹스된 녹음을 오디오 URL로 제공하세요. 업로드 컨트롤에서는 MP3 또는 WAV를 사용할 수 있어요. 1자 이상 |
요금
$0.0012 / 초
입력 오디오의 초 단위 길이에 대해 한 번만 과금하며, 소수점 이하 시간은 초 단위로 올림해요. 두 스템 모두 동일한 길이 요금에 포함돼요. 이 엔드포인트는 1~600초를 허용해요.
활용 사례
텍스트 → audio-separation → 오디오
audio-separation
오디오
비동기 작업
프롬프트 가이드 및 실전 팁
소개
Vocal Isolator는 기존 오디오 녹음을 보컬 트랙과 배경 트랙으로 분리해요. 믹스된 녹음을 audio_url로 보내면 돼요. 프롬프트나 이전에 생성한 음악 작업은 필요하지 않아요. 이 엔드포인트는 곡 리허설, 내레이션이 있는 클립, 음악이 깔린 팟캐스트 녹음처럼 이미 가지고 있는 소리를 다루기 위한 기능이에요.
주요 기능과 특징
하나의 녹음에서 두 스템으로
이 작업은 같은 원본의 두 부분을 반환하도록 설계되었어요. 첫 번째는 보컬, 두 번째는 나머지 배경이에요. 음악에서 배경은 악기 반주를 뜻해요. 말소리가 담긴 녹음에서는 음악과 환경음이 포함될 수 있어요. 이는 한 번의 처리에서 나온 서로 연관된 스템이며, 둘 중 하나를 고르는 별개의 생성 결과가 아니에요. 분리 후에도 소리가 섞여 들리거나 두 부분에 겹치는 세부 소리가 사라질 수 있어요.
원본 길이가 과금 수량을 결정해요
과금은 입력 녹음 길이를 기준으로 하며 초 단위로 올림해요. 스템 두 개를 받아도 해당 길이가 두 배로 계산되지는 않아요. 이 엔드포인트는 1~600초의 녹음을 허용해요. 원하는 출력 길이, 화자 선택 또는 출력 코덱 설정은 제공하지 않아요. 두 결과와 함께 원본 믹스를 보관하면 처음 사용한 녹음을 잃지 않고 분리 결과를 비교할 수 있어요.
활용 사례
음악 연습용 트랙 준비하기
배경 스템을 나만의 반주 트랙으로 삼아 연습하고, 보컬 스템은 프레이징을 확인하는 데 사용하세요. 큰 소리가 나는 부분뿐 아니라 쉬는 구간도 들어 보세요. 잔향이나 코러스가 반주에 남을 수 있어요. 스템이 연습에 적합한지 판단하기 전에 비슷한 청취 음량으로 비교하세요.
기존 믹스에서 내레이션 분리하기
음악 위에 말소리가 있는 클립이라면 보컬 결과를 새 편집에 넣기 전에 들어 보세요. 배경 스템은 편집 참고용으로 유용할 수 있지만, 음악만 들어 있다고 보장되지는 않아요. 편집기에서 비교할 때는 두 스템을 같은 원본 시작 지점에 맞춰 정렬하세요.
프롬프트 가이드와 활용 팁
원본 녹음 준비하기
조정할 프롬프트는 없어요. 스피커로 재생한 소리를 다시 녹음한 파일이나 한 번 더 압축한 복사본 대신, 보유한 믹스 녹음 중 가장 선명한 버전을 업로드하세요. 업로드 컨트롤에서 MP3 또는 WAV를 사용하세요. 이 엔드포인트는 제공된 파일 전체를 처리해요. 긴 녹음 중 일부만 필요하다면 먼저 별도의 원본 클립을 준비하세요. 원본을 보관하고, 분리된 스템에는 서로 다른 이름을 붙이세요.
사용하기 전에 두 트랙 모두 확인하기
말소리의 자음, 길게 이어지는 음, 구절 사이의 무음, 좌우 채널을 확인하세요. 보컬에 음악 소리가 섞여 있거나 배경에 목소리가 남아 있는지 들어 보세요. 두 스템을 다시 합치면 원본이 정확히 복원된다고 가정하지 마세요. 긴 시퀀스를 편집하기 전에 실제 길이를 측정하고, 사용할 편집기에서 정렬을 확인하세요. 출력 형식, 샘플 레이트 및 분리 품질은 사용자의 소재로 검증해야 해요.
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": "spicyapi/vocal-isolator-v1/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 레퍼런스에서 확인하세요.