StemSplit API: Integrasikan Pemisahan Stem AI ke Aplikasi Anda

StemSplit API kini tersedia untuk umum. Jika Anda sedang membangun aplikasi karaoke, mengotomasi ekstraksi stem untuk perpustakaan musik, atau menambahkan penghapusan vokal ke pipeline produksi, Anda bisa melakukannya secara programatik sekarang.

API ini menyediakan kualitas pemisahan AI yang sama seperti aplikasi web — model HTDemucs FT yang sama, infrastruktur pemrosesan yang sama — melalui endpoint REST sederhana dengan notifikasi webhook dan dukungan URL YouTube langsung.

Apa yang Bisa Anda Bangun

Pemisahan Stem dari Audio Apa Pun

Upload file MP3, WAV, FLAC, atau M4A dan ekstrak:

Proses Video YouTube Secara Langsung

Kirimkan URL YouTube dan dapatkan stem yang terpisah kembali — tidak perlu mengunduh terlebih dahulu:

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

Notifikasi Webhook

Daftarkan endpoint webhook dan terima POST ketika pekerjaan selesai, alih-alih melakukan polling:

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

Payload webhook menyertakan tanda tangan HMAC-SHA256 untuk verifikasi.

---

Siap memulai? Dapatkan API key Anda — akun baru mendapatkan 10 menit gratis untuk pengujian.

---

Cara Kerjanya

Langkah 1: Upload audio langsung melalui presigned URL, atau kirimkan sourceUrl yang mengarah ke file yang sudah ada.

Langkah 2: Buat pekerjaan:

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

Langkah 3: Terima hasil melalui webhook atau polling endpoint status pekerjaan. Unduh stem dari URL yang diberikan setelah pekerjaan selesai. Waktu pemrosesan tipikal adalah 1–3 menit tergantung durasi audio dan pengaturan kualitas.

Contoh: Generator Karaoke dalam 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)

Itulah logika lengkap untuk generator karaoke — sekitar 30 baris dari pemanggilan API hingga URL unduhan.

Panduan Integrasi

Dokumentasi mencakup kasus penggunaan yang paling umum:

Referensi Teknis

Autentikasi

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Buat kunci di Settings → API Keys. Setiap akun mendukung hingga 5 kunci aktif.

Batas Rate dan Batasan

Format yang Didukung

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

Output: MP3, WAV, FLAC (tentukan dalam permintaan pekerjaan)

Pengaturan Kualitas

Harga

API menggunakan sistem kredit yang sama dengan aplikasi web — tidak ada harga API terpisah, tidak diperlukan langganan. Kredit dibeli sesuai kebutuhan dan tidak pernah kedaluwarsa. Akun baru menerima 10 menit gratis untuk pengujian. Tarif saat ini ada di halaman harga.

Dokumentasi

• Memulai — Panduan cepat dengan contoh kode dalam cURL, Python, dan JavaScript
• Referensi API — Dokumentasi endpoint lengkap dengan skema permintaan dan respons
• Panduan Integrasi — Tutorial langkah demi langkah untuk platform dan kasus penggunaan tertentu

Pertanyaan yang Sering Diajukan

Apa bedanya dengan aplikasi web? Model AI yang sama, kualitas yang sama, kredit yang sama — API menyediakan akses programatik untuk otomasi dan integrasi. Aplikasi web untuk pemrosesan individual satu kali.

Apakah saya memerlukan langganan? Tidak. Beli kredit saat dibutuhkan. Tidak kedaluwarsa.

Bisakah saya menggunakan ini dalam produk komersial? Ya. API dirancang untuk integrasi ke dalam produk dan alur kerja. Kredit Anda membayar untuk pemrosesan.

Bagaimana cara menangani webhook dengan aman? Verifikasi tanda tangan HMAC-SHA256 pada setiap payload webhook menggunakan API key Anda sebagai rahasia. Tolak permintaan apa pun yang tidak tervalidasi. Detail di referensi API.

Bisakah saya memproses video, bukan hanya audio? API memproses audio. Untuk URL YouTube, kami mengekstrak track audio secara otomatis. Untuk file video, ekstrak audionya terlebih dahulu dan kirimkan itu.

---

Mulai Membangun

1. Buat akun
2. Buat API key
3. Baca dokumentasi

Akun baru mendapatkan 10 menit gratis. Tidak diperlukan kartu kredit untuk pengujian.

Dapatkan API Key Anda →