StemSplit API: KI-gestützte Stem-Trennung in Ihre Apps integrieren

Die StemSplit API ist öffentlich verfügbar. Wenn Sie eine Karaoke-App erstellen, die Stem-Extraktion für eine Musikbibliothek automatisieren oder Vokalentfernung in eine Produktions-Pipeline einbinden möchten, können Sie das jetzt programmatisch tun.

Die API bietet dieselbe KI-Trennungsqualität wie die Web-App — dasselbe HTDemucs-FT-Modell, dieselbe Verarbeitungsinfrastruktur — über einfache REST-Endpunkte mit Webhook-Benachrichtigungen und direkter YouTube-URL-Unterstützung.

Was Sie damit erstellen können

Stem-Trennung aus beliebigem Audio

Laden Sie MP3-, WAV-, FLAC- oder M4A-Dateien hoch und extrahieren Sie:

YouTube-Videos direkt verarbeiten

Übergeben Sie eine YouTube-URL und erhalten Sie getrennte Stems zurück — kein vorheriges Herunterladen erforderlich:

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"}'

Webhook-Benachrichtigungen

Registrieren Sie einen Webhook-Endpunkt und erhalten Sie ein POST, wenn Jobs abgeschlossen sind, anstatt zu pollen:

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

Webhook-Payloads enthalten HMAC-SHA256-Signaturen zur Verifizierung.

---

Bereit loszulegen? Holen Sie sich Ihren API-Schlüssel — neue Konten erhalten 5 kostenlose Minuten zum Testen.

---

So funktioniert es

Schritt 1: Audio direkt über eine presigned URL hochladen oder eine sourceUrl übergeben, die auf eine bestehende Datei verweist.

Schritt 2: Einen Job erstellen:

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"
  }'

Schritt 3: Ergebnisse über Webhook empfangen oder den Job-Status-Endpunkt abfragen. Stems von den bereitgestellten URLs herunterladen, sobald der Job abgeschlossen ist. Typische Verarbeitungszeit ist 1–3 Minuten, abhängig von der Audiolänge und Qualitätseinstellung.

Beispiel: Karaoke-Generator in 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)

Das ist die vollständige Logik für einen Karaoke-Generator — etwa 30 Zeilen vom API-Aufruf bis zur Download-URL.

Integrations-Leitfäden

Die Dokumentation deckt die häufigsten Anwendungsfälle ab:

Technische Referenz

Authentifizierung

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Generieren Sie Schlüssel unter Einstellungen → API-Schlüssel. Jedes Konto unterstützt bis zu 5 aktive Schlüssel.

Ratenlimits und Beschränkungen

Unterstützte Formate

Eingabe: MP3, WAV, FLAC, M4A, OGG, WebM

Ausgabe: MP3, WAV, FLAC (in Job-Anfrage angeben)

Qualitätseinstellungen

Preisgestaltung

Die API verwendet dasselbe Kreditsystem wie die Web-App — keine separate API-Preisgestaltung, kein Abonnement erforderlich. Credits werden nach Bedarf gekauft und laufen nie ab. Neue Konten erhalten 5 kostenlose Minuten zum Testen. Aktuelle Preise finden Sie auf der Preisseite.

Dokumentation

• Erste Schritte — Schnellstart mit Code-Beispielen in cURL, Python und JavaScript
• API-Referenz — Vollständige Endpunkt-Dokumentation mit Anfrage- und Antwortschemata
• Integrations-Leitfäden — Schritt-für-Schritt-Tutorials für spezifische Plattformen und Anwendungsfälle

Häufig gestellte Fragen

Wie unterscheidet sich das von der Web-App? Gleiches KI-Modell, gleiche Qualität, gleiche Credits — die API bietet programmatischen Zugang für Automatisierung und Integration. Die Web-App ist für individuelle einmalige Verarbeitung.

Benötige ich ein Abonnement? Nein. Kaufen Sie Credits, wenn Sie sie benötigen. Sie laufen nicht ab.

Kann ich das in kommerziellen Produkten verwenden? Ja. Die API ist für die Integration in Produkte und Workflows konzipiert. Ihre Credits bezahlen die Verarbeitung.

Wie sichere ich Webhooks ab? Verifizieren Sie die HMAC-SHA256-Signatur bei jedem Webhook-Payload mit Ihrem API-Schlüssel als Geheimnis. Lehnen Sie alle Anfragen ab, die nicht validiert werden. Details in der API-Referenz.

Kann ich Videos verarbeiten, nicht nur Audio? Die API verarbeitet Audio. Für YouTube-URLs extrahieren wir den Audio-Track automatisch. Für Videodateien extrahieren Sie zuerst das Audio und übermitteln Sie das.

---

Beginnen Sie mit dem Entwickeln

1. Konto erstellen
2. API-Schlüssel generieren
3. Dokumentation lesen

Neue Konten enthalten 5 kostenlose Minuten. Keine Kreditkarte zum Testen erforderlich.

Ihren API-Schlüssel erhalten →