Vokal kaldırma API'si

2026-09-18 tarihinde güncellendi · Suno-API ekibi

Uç nokta açıklaması

Vokal kaldırma, var olan bir şarkıyı iki kanala ayırır: vokal ve eşlik. Parça ayırmanın kısa biçimidir: yalnızca kaynak şarkı kimliğini gönderirsiniz, ayırma modu seçmeniz gerekmez ve sunucu her zaman iki kanal (two) olarak işler.

Uç nokta: POST /api/music/vocal-removal

Faturalama: Ücretsiz. Bu uç nokta yalnızca kanalları ayırır; üretim maliyeti doğurmaz ve ücret kaydı yazmaz.

Önerilen model: suno-v6. suno-v6, suno-v6-wild ve suno-v6-mini kullanılabilir.

Kimlik doğrulama

Parametre	Tür	Zorunlu	Notlar
Authorization	string	evet	`Bearer YOUR_API_KEY`
Content-Type	string	evet	`application/json`

İstek parametreleri

Parametre	Tür	Zorunlu	Varsayılan	Notlar
model	string	evet	-	Müşteriye görünen model adı: `suno-v6`, `suno-v6-wild` veya `suno-v6-mini`
source_clip_id	string	evet	-	Kaynak şarkının gerçek `song_id` değeri; tamamlanmış olmalı ve geçerli API anahtarıyla erişilebilmelidir
source_audio_url	string	hayır	-	Kaynak ses adresi (kaynak başka bir hesaba aitse sunucu aktarımı yapar; istemcinin göndermesine gerek yoktur)
source_file_name	string	hayır	-	Kaynak dosya adı; yalnızca günlük ve gösterim için kullanılır
song_title	string	hayır	-	Sonuç başlığı öneki; varsayılan olarak kaynak şarkının başlığı korunur

Uyumlu takma adlar: sourceClipId, audio_id, audioId ve song_id değerlerinin tümü source_clip_id yerine kullanılabilir.

İstek örneği

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "Vokal kaldırma"
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Vokal kaldırma (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Vokal kaldırma (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Tek bir gönderim 2 sürüm × {Vocals, Instrumental} döndürür, bu nedenle clips genellikle 4 kayıt içerir. stem_from_id ile gruplayın ve vokali eşlikten song_title son ekiyle ayırın.

Notlar

Sonuç kanallarını kullanmadan önce şarkı sorgulama ve geçmiş API'si (POST /api/music/query) ile completed olana kadar sorgulayın; GET /api/music/songs/:song_id ve şarkı geçmişi listesi şu anda vokal kaldırmanın ürettiği kanalları içermez — bu bilinen bir farktır.
İki kanal veya çok kanallı mod seçmek ya da kanal adına göre ayırmak istiyorsanız parça ayırma (vokal ve eşlik) API'sini kullanın.
Gereksiz kanallar kanal silme API'si ile gizlenebilir; silme isteğini tekrar tekrar göndermeyin.

SonrakiStem silme API'si

API anahtarı alın

Kaydolduktan sonra konsoldan bir API anahtarı oluşturun. Her üretim 0,6 ¥ tutarındadır ve 2 parça döner, indirmeler sınırsızdır ve telefon numarası gerekmez.

API anahtarı al Genel bakışa dön