---
title: "StemSplit API: Yapay Zeka Stem Ayrımını Uygulamalarınıza Entegre Edin"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "geliştiriciler", "stem ayrımı", "vokal kaldırma", "otomasyon", "webhooks", "entegrasyon"]
excerpt: "StemSplit API, geliştiricilere yapay zeka destekli vokal kaldırma ve stem ayrımına programatik erişim sağlar — REST endpoint'ler, webhook'lar, YouTube URL desteği ve web uygulamasıyla aynı kullanım başına ödeme kredi sistemi."
abstract: "StemSplit API artık herkese açık. Karaoke uygulaması geliştiriyorsanız, bir müzik kütüphanesi için stem çıkarmayı otomatize ediyorsanız ya da bir prodüksiyon pipeline'ına vokal kaldırma ekliyorsanız, bunu artık programatik olarak yapabilirsiniz."
locale: "tr"
canonical: "https://stemsplit.io/tr/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/tr/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 artık herkese açık. Karaoke uygulaması geliştiriyorsanız, bir müzik kütüphanesi için stem çıkarmayı otomatize ediyorsanız ya da bir prodüksiyon pipeline'ına vokal kaldırma ekliyorsanız, bunu artık programatik olarak yapabilirsiniz.

API, [web uygulamasıyla](/stem-splitter) aynı yapay zeka ayrım kalitesini sunar — aynı HTDemucs FT modeli, aynı işleme altyapısı — webhook bildirimleri ve doğrudan YouTube URL desteğiyle basit REST endpoint'ler aracılığıyla.

## Neler İnşa Edebilirsiniz

### Herhangi Bir Sesten Stem Ayrımı

MP3, WAV, FLAC veya M4A dosyaları yükleyin ve çıkarın:

| Çıktı Türü | Ne Alırsınız |
|---|---|
| `VOCALS` | İzole edilmiş vokaller |
| `INSTRUMENTAL` | Vokal dışında her şey (karaoke parçası) |
| `BOTH` | Vokaller + enstrümantal ayrı dosyalar olarak |
| `FOUR_STEMS` | Vokaller, davullar, bas, diğerleri |
| `SIX_STEMS` | Vokaller, davullar, bas, gitar, piyano, diğerleri |

### YouTube Videolarını Doğrudan İşleyin

Bir YouTube URL'si gönderin ve ayrılmış stem'leri geri alın — önce indirmenize gerek yok:

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

### Webhook Bildirimleri

Bir webhook endpoint'i kaydedin ve işler tamamlandığında polling yerine POST alın:

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

Webhook yükleri, doğrulama için HMAC-SHA256 imzaları içerir.

---

**Başlamaya hazır mısınız?** [API anahtarınızı alın](/developers) — yeni hesaplara test için 5 dakika ücretsiz verilir.

---

## Nasıl Çalışır

**Adım 1:** Sesi doğrudan önceden imzalanmış URL aracılığıyla yükleyin veya mevcut bir dosyaya işaret eden `sourceUrl` gönderin.

**Adım 2:** Bir iş oluşturun:

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

**Adım 3:** Sonuçları webhook aracılığıyla alın ya da iş durumu endpoint'ini sorgulayın. İş tamamlandığında sağlanan URL'lerden stem'leri indirin. Tipik işleme süresi ses uzunluğuna ve kalite ayarına bağlı olarak 1–3 dakikadır.

## Örnek: Python'da Karaoke Üreteci

```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)
```

Bir karaoke üreteci için tam mantık budur — API çağrısından indirme URL'sine yaklaşık 30 satır.

## Entegrasyon Rehberleri

Dokümantasyon en yaygın kullanım durumlarını kapsar:

| Platform | Neler İnşa Edebilirsiniz |
|---|---|
| [n8n](/developers/guides/n8n) | Otomatik iş akışları — bulut depolamadan dosya işleme, sonuçları Slack veya e-postaya yönlendirme |
| [Zapier](/developers/guides/zapier) | StemSplit'i 5.000'den fazla uygulamaya bağlayan kodsuz otomasyon |
| [Make](/developers/guides/make) | Çok adımlı işleme iş akışları için görsel senaryo oluşturucu |
| [Discord Bot](/developers/guides/discord-bot) | Müzik sunucuları için stem ayrım botu |
| [White Label](/developers/guides/white-label) | Kendi ürününüze kendi markanız altında stem ayrımı ekleyin |

## Teknik Referans

### Kimlik Doğrulama

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

[Settings → API Keys](/developers) bölümünde anahtarlar oluşturun. Her hesap en fazla 5 aktif anahtarı destekler.

### Hız Sınırları ve Kısıtlamalar

| Sınır | Değer |
|---|---|
| Dakikada istek | 60 |
| Maksimum dosya boyutu | 50 MB |
| Maksimum ses süresi | 60 dakika |
| Hesap başına API anahtarı | 5 |
| Hesap başına webhook | 5 |

### Desteklenen Formatlar

**Girdi:** MP3, WAV, FLAC, M4A, OGG, WebM

**Çıktı:** MP3, WAV, FLAC (iş isteğinde belirtin)

### Kalite Ayarları

| Ayar | Hız | Kullanım Durumu |
|---|---|---|
| `FAST` | Ses dakikası başına ~20 saniye | Hızlı önizlemeler, test |
| `BALANCED` | Dakika başına ~40 saniye | Genel kullanım |
| `BEST` | Dakika başına ~60 saniye | Prodüksiyon kalitesi; 6 stem için gerekli |

## Fiyatlandırma

API, web uygulamasıyla aynı kredi sistemini kullanır — ayrı API fiyatlandırması yok, abonelik gerekmiyor. Krediler ihtiyaç duyuldukça satın alınır ve asla sona ermez. Yeni hesaplar test için 5 dakika ücretsiz alır. Güncel oranlar [fiyatlandırma sayfasında](/pricing) yer alıyor.

## Dokümantasyon

- **[Başlangıç](/developers/docs)** — cURL, Python ve JavaScript'te kod örnekleriyle hızlı başlangıç
- **[API Referansı](/developers/reference)** — İstek ve yanıt şemalarıyla tam endpoint dokümantasyonu
- **[Entegrasyon Rehberleri](/developers/guides)** — Belirli platformlar ve kullanım durumları için adım adım öğreticiler

## Sık Sorulan Sorular

**Bu web uygulamasından nasıl farklı?**
Aynı yapay zeka modeli, aynı kalite, aynı krediler — API, otomasyon ve entegrasyon için programatik erişim sağlar. Web uygulaması, bireysel tek seferlik işlemler içindir.

**Aboneliğe ihtiyacım var mı?**
Hayır. İhtiyaç duyduğunuzda kredi satın alın. Sona ermezler.

**Bunu ticari ürünlerde kullanabilir miyim?**
Evet. API, ürünlere ve iş akışlarına entegrasyon için tasarlanmıştır. Kredileriniz işleme için ödeme yapar.

**Webhook'ları güvenli şekilde nasıl yönetirim?**
API anahtarınızı gizli anahtar olarak kullanarak her webhook yükündeki HMAC-SHA256 imzasını doğrulayın. Doğrulanmayan tüm istekleri reddedip. Ayrıntılar [API referansında](/developers/reference).

**Video işleyebilir miyim, yalnızca ses değil mi?**
API ses işler. YouTube URL'leri için ses parçasını otomatik olarak çıkarırız. Video dosyaları için önce sesi çıkarın ve onu gönderin.

---

## İnşa Etmeye Başlayın

1. [Hesap oluşturun](/free-trial)
2. [API anahtarı oluşturun](/developers)
3. [Dokümantasyonu okuyun](/developers/docs)

Yeni hesaplar 5 dakika ücretsiz içerir. Test için kredi kartı gerekmez.

[API Anahtarınızı Alın →](/developers)

---

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