StemSplit API: AI 스템 분리를 앱에 통합하기

StemSplit API가 공개적으로 사용 가능합니다. 노래방 앱을 만들거나, 음악 라이브러리에서 스템 추출을 자동화하거나, 프로덕션 파이프라인에 보컬 제거를 추가하려면, 이제 프로그래밍 방식으로 할 수 있습니다.

API는 웹 앱과 동일한 AI 분리 품질을 제공합니다 — 동일한 HTDemucs FT 모델, 동일한 처리 인프라 — 웹훅 알림과 직접 YouTube URL 지원이 있는 간단한 REST 엔드포인트를 통해.

만들 수 있는 것

모든 오디오에서 스템 분리

MP3, WAV, FLAC, 또는 M4A 파일을 업로드하고 추출하세요:

YouTube 동영상 직접 처리

YouTube URL을 전달하면 분리된 스템을 받을 수 있습니다 — 먼저 다운로드할 필요 없이:

curl -X POST https://stemsplit.io/api/v1/youtube-jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"youtubeUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'

웹훅 알림

웹훅 엔드포인트를 등록하고 폴링하는 대신 작업이 완료되면 POST를 받으세요:

{
  "event": "job.completed",
  "timestamp": "2026-01-05T12:30:00Z",
  "data": {
    "jobId": "clxxx123...",
    "status": "COMPLETED",
    "outputs": {
      "vocals": { "url": "https://...", "expiresAt": "..." },
      "instrumental": { "url": "https://...", "expiresAt": "..." }
    }
  }
}

웹훅 페이로드에는 검증을 위한 HMAC-SHA256 서명이 포함됩니다.

---

시작할 준비가 됐나요? API 키 받기 — 새 계정은 테스트용으로 10분의 무료 시간을 받습니다.

---

작동 방식

Step 1: 미리 서명된 URL을 통해 오디오를 직접 업로드하거나, 기존 파일을 가리키는 sourceUrl을 전달하세요.

Step 2: 작업 생성:

curl -X POST https://stemsplit.io/api/v1/jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/song.mp3",
    "outputType": "BOTH",
    "quality": "BEST"
  }'

Step 3: 웹훅을 통해 결과를 받거나 작업 상태 엔드포인트를 폴링하세요. 작업이 완료되면 제공된 URL에서 스템을 다운로드하세요. 일반적인 처리 시간은 오디오 길이와 품질 설정에 따라 1~3분입니다.

예시: Python으로 노래방 생성기 만들기

import requests
import time

API_KEY = "sk_live_xxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    "https://stemsplit.io/api/v1/jobs",
    headers=HEADERS,
    json={
        "sourceUrl": "https://example.com/song.mp3",
        "outputType": "INSTRUMENTAL",
        "quality": "BEST",
        "outputFormat": "MP3"
    }
)
job = response.json()
print(f"Created job: {job['id']}")

while True:
    status = requests.get(
        f"https://stemsplit.io/api/v1/jobs/{job['id']}",
        headers=HEADERS
    ).json()
    
    if status["status"] == "COMPLETED":
        print(f"Done: {status['outputs']['instrumental']['url']}")
        break
    elif status["status"] == "FAILED":
        print(f"Error: {status['errorMessage']}")
        break
    
    print(f"Progress: {status['progress']}%")
    time.sleep(5)

API 호출부터 다운로드 URL까지 약 30줄로 노래방 생성기의 완전한 로직입니다.

통합 가이드

문서는 가장 일반적인 사용 사례를 다룹니다:

기술 참조

인증

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

설정 → API 키에서 키를 생성하세요. 각 계정은 최대 5개의 활성 키를 지원합니다.

속도 제한 및 제약

지원 형식

입력: MP3, WAV, FLAC, M4A, OGG, WebM

출력: MP3, WAV, FLAC (작업 요청에서 지정)

품질 설정

가격

API는 웹 앱과 동일한 크레딧 시스템을 사용합니다 — 별도의 API 가격 없음, 구독 필요 없음. 크레딧은 필요에 따라 구매하며 만료되지 않습니다. 새 계정은 테스트를 위해 10분 무료를 받습니다. 현재 요율은 가격 페이지에 있습니다.

문서

• 시작하기 — cURL, Python, JavaScript의 코드 예시를 포함한 빠른 시작
• API 참조 — 요청 및 응답 스키마가 있는 완전한 엔드포인트 문서
• 통합 가이드 — 특정 플랫폼 및 사용 사례에 대한 단계별 튜토리얼

자주 묻는 질문

웹 앱과 어떻게 다른가요? 동일한 AI 모델, 동일한 품질, 동일한 크레딧 — API는 자동화 및 통합을 위한 프로그래밍 방식의 접근을 제공합니다. 웹 앱은 개별 일회성 처리를 위한 것입니다.

구독이 필요한가요? 아니요. 필요할 때 크레딧을 구매하세요. 만료되지 않습니다.

상업 제품에 사용할 수 있나요? 네. API는 제품과 워크플로우에 통합하기 위해 만들어졌습니다. 크레딧이 처리 비용을 지불합니다.

웹훅을 안전하게 처리하는 방법은? API 키를 시크릿으로 사용하여 모든 웹훅 페이로드의 HMAC-SHA256 서명을 확인하세요. 검증되지 않는 모든 요청을 거부하세요. 세부 사항은 API 참조에 있습니다.

오디오뿐만 아니라 동영상도 처리할 수 있나요? API는 오디오를 처리합니다. YouTube URL의 경우 오디오 트랙을 자동으로 추출합니다. 동영상 파일의 경우 먼저 오디오를 추출하고 제출하세요.

---

시작하기

1. 계정 만들기
2. API 키 생성
3. 문서 읽기

새 계정에는 10분 무료가 포함됩니다. 테스트에 신용카드가 필요하지 않습니다.

API 키 받기 →