---
title: "StemSplit API: AI 스템 분리를 앱에 통합하기"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "개발자", "스템 분리", "보컬 제거", "자동화", "웹훅", "통합"]
excerpt: "StemSplit API는 개발자에게 AI 기반 보컬 제거 및 스템 분리에 대한 프로그래밍 방식의 접근을 제공합니다 — REST 엔드포인트, 웹훅, YouTube URL 지원, 그리고 웹 앱과 동일한 사용량 기반 크레딧."
abstract: "StemSplit API가 공개적으로 사용 가능합니다. 노래방 앱을 만들거나, 음악 라이브러리에서 스템 추출을 자동화하거나, 프로덕션 파이프라인에 보컬 제거를 추가하려면, 이제 프로그래밍 방식으로 할 수 있습니다."
locale: "ko"
canonical: "https://stemsplit.io/ko/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/ko/blog/stemsplit-api-launch  
> Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates.

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

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

## 만들 수 있는 것

### 모든 오디오에서 스템 분리

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

| 출력 유형 | 결과물 |
|---|---|
| `VOCALS` | 분리된 보컬 |
| `INSTRUMENTAL` | 보컬을 제외한 모든 것 (노래방 트랙) |
| `BOTH` | 보컬 + 반주 별도 파일로 |
| `FOUR_STEMS` | 보컬, 드럼, 베이스, 기타 |
| `SIX_STEMS` | 보컬, 드럼, 베이스, 기타, 피아노, 기타 |

### YouTube 동영상 직접 처리

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

```bash
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를 받으세요:

```json
{
  "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 키 받기](/developers) — 새 계정은 테스트용으로 5분의 무료 시간을 받습니다.

---

## 작동 방식

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

**Step 2:** 작업 생성:

```bash
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으로 노래방 생성기 만들기

```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줄로 노래방 생성기의 완전한 로직입니다.

## 통합 가이드

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

| 플랫폼 | 만들 수 있는 것 |
|---|---|
| [n8n](/developers/guides/n8n) | 자동화된 워크플로우 — 클라우드 스토리지에서 파일 처리, 결과를 Slack이나 이메일로 라우팅 |
| [Zapier](/developers/guides/zapier) | StemSplit을 5,000개 이상의 앱에 연결하는 노코드 자동화 |
| [Make](/developers/guides/make) | 다단계 처리 워크플로우를 위한 비주얼 시나리오 빌더 |
| [Discord 봇](/developers/guides/discord-bot) | 음악 서버용 스템 분리 봇 |
| [화이트 라벨](/developers/guides/white-label) | 자신의 브랜드 아래 제품에 스템 분리 내장 |

## 기술 참조

### 인증

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

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

### 속도 제한 및 제약

| 제한 | 값 |
|---|---|
| 분당 요청 수 | 60 |
| 최대 파일 크기 | 50 MB |
| 최대 오디오 길이 | 60분 |
| 계정당 API 키 수 | 5 |
| 계정당 웹훅 수 | 5 |

### 지원 형식

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

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

### 품질 설정

| 설정 | 속도 | 사용 사례 |
|---|---|---|
| `FAST` | 오디오 1분당 약 20초 | 빠른 미리보기, 테스트 |
| `BALANCED` | 오디오 1분당 약 40초 | 일반 사용 |
| `BEST` | 오디오 1분당 약 60초 | 프로덕션 품질; 6-스템에 필요 |

## 가격

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

## 문서

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

## 자주 묻는 질문

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

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

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

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

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

---

## 시작하기

1. [계정 만들기](/free-trial)
2. [API 키 생성](/developers)
3. [문서 읽기](/developers/docs)

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

[API 키 받기 →](/developers)

---

*This article was originally published at https://stemsplit.io/ko/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*