소개
엔드포인트 기능
영상 오디오 트랙에서 배경 음악을 제거하고 같은 영상을 반환합니다. 화면은 처리하지 않습니다.
주요 입력
유일한 필드는 video_url입니다. 최대 10분 영상을 업로드하거나 직접 링크합니다.
반환 결과
원본 프레임 크기, 프레임레이트, 길이와 음악이 없는 오디오 트랙의 MP4 1개입니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 엔드포인트 | 영상 편집 |
| 유지 항목 | 대화, 화면, 길이, 프레임레이트 |
| 요금 | 원본 초당 과금, 최소 3초분 |
핵심 기능 및 하이라이트
재즈는 빼고 대화는 남깁니다
위는 와인 저장고의 8초 대화에 재즈 트리오를 섞은 오디오이며 아래는 출력입니다. 지속적인 음악 선은 사라지고 말소리는 유지되며 마지막 말 뒤는 조용해졌습니다.
화면을 그대로 반환합니다
오디오만 처리합니다. 정리된 클립은 업로드와 같은 1280×720 프레임, 24 fps, 길이이므로 편집에 바로 넣을 수 있습니다.
대화는 남기고 노래는 제거
말소리는 남기고 음악은 빼야 할 때 사용합니다. 음악을 별도 스템으로 원한다면 오디오 파일의 두 부분을 모두 반환하는 Vocal Isolator를 사용합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 배경 음악을 제거할 최대 10분 영상입니다. MP4나 WebM 파일을 올리거나 파일 직접 링크를 넣으세요. 1자 이상 |
요금
$0.0024 / 출력 초
원본 영상 길이를 초 단위로 올림해 최소 3초분을 과금합니다. 10분을 넘는 클립은 제출 시 거부됩니다. 실패한 요청은 과금하지 않습니다.
활용 사례
라이선스 곡 없이 다시 게시
클립에서 저작권이 있는 음악을 빼고 대화는 남겨 사용 권한이 있는 음악과 함께 게시합니다.
편집본 음악 교체
별도 대화 스템으로 돌아가지 않고 임시 편집본의 가이드 음악을 최종 음악으로 바꿉니다.
더빙용 영상 준비
말소리를 번역하기 전에 배경 음악을 제거하고 새 목소리 아래 음악을 다시 더합니다.
프롬프트 가이드 및 실전 팁
영상을 전송합니다
최대 10분의 MP4나 WebM을 업로드하거나 파일의 직접 링크를 전달합니다. 다른 설정은 없습니다.
작업 완료를 기다립니다
테스트에서 8초 클립은 약 77초가 걸렸습니다. 긴 클립은 더 오래 걸립니다.
새 소리를 추가합니다
정리된 트랙에 새 음악을 깔거나 클립을 더빙 도구로 보냅니다. 화면이 바뀌지 않아 동기화가 유지됩니다.
소개
Video Music Remover는 영상에서 배경 음악을 빼서 반환합니다. 대화는 남기고 화면은 변경하지 않습니다. 라이선스 곡을 제거하거나 임시 음악을 바꾸고 더빙용 클립을 빠르게 준비할 수 있습니다.
요청
{
"video_url": "https://example.com/vlog.mp4"
}
필드는 video_url뿐이며 최대 10분 클립을 지원합니다.
테스트 결과
와인 저장고에서 두 사람이 대화하는 8초, 1280×720 클립에 목소리보다 약 4 dB 낮게 재즈 트리오를 섞었습니다. 약 77초 후 1280×720, 24 fps로 반환되었습니다. 원래의 깨끗한 대화와 비교했을 때 출력에서 음악은 더 이상 검출되지 않았고 두 목소리는 유지되며 마지막 말 뒤의 침묵도 깨끗했습니다.
작업 흐름
호출은 비동기식입니다. 작업을 만든 뒤 끝날 때까지 상태를 확인하고, 완성된 MP4를 SpicyAPI 저장소에서 받습니다. 원본 영상 길이로 초당 과금하며 실패한 요청은 과금하지 않습니다.
팁
- 노래하는 목소리는 음악으로 처리되므로 배경 보컬 트랙도 제거됩니다.
- 음악을 별도 파일로 원한다면 오디오를 추출해 Vocal Isolator (
/models/vocal-isolator-v1)를 사용합니다. - 음악 없이 말소리에 소음만 있다면 ElevenLabs Audio Isolation (
/models/elevenlabs-audio-isolation)이 더 적합합니다.
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/music-remover-v1/video-edit",
"input": {
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 레퍼런스에서 확인하세요.

