Enstrümantal ekleme API'si

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

Uç nokta açıklaması

Enstrümantal ekleme, var olan bir şarkıyı yeniden düzenler, ona enstrüman ekler veya yeni bir eşlik yapısı üretir.

Uç nokta: POST /api/music/add-instrumental

Faturalama: Ücretli, istenen modele göre faturalanır; gerçekte tahsil edilen tutar arka ofis fiyat yapılandırmasına göre belirlenir.

Max Mode / Variety: bu uç nokta isteğe bağlı max_mode ve variety (0-4) parametrelerini destekler. max_mode açıkken bu çağrı iki katı fiyatla faturalanır; variety ek ücret doğurmaz. Ne anlama geldikleri ve nasıl gönderilecekleri Yeni API genel bakışı sayfasındaki "Gelişmiş parametreler" bölümündedir.

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

Bekleme süreleri ve zaman aşımları (önemli): bu uç nokta senkrondur — sipariş ancak yanıt geldiğinde kabul edilir ve üretime verilir. Ölçümlere göre isteklerin çoğu 1-3 saniyede yanıtlanır, yaklaşık %10'u 30 saniyeyi aşar ve en uzunu yaklaşık 230 saniyedir. İstemci zaman aşımını 300 saniye veya üzerine ayarlayın; yanıt gelmemesi hiçbir şey üretilmediği anlamına gelmez ve zaman aşımından hemen sonra yeniden denemeyin (siparişi çoğaltır ve tekrar ücret alır). Bağlantı koptuysa daha sonra GET /api/music/songs ile kontrol edin. Yeni API genel bakışı sayfasındaki "Bekleme süreleri ve zaman aşımı ayarları" bölümüne bakın.

Kimlik doğrulama

İstek parametreleri

İstek örneği

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "Güçlendirilmiş eşlik sürümü",
    "audio_weight": 1,
    "wait_completion": false
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Güçlendirilmiş eşlik sürümü",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Güçlendirilmiş eşlik sürümü",
        "status": "pending"
      }
    ]
  }
}

Bir çağrı 2 sonuç döndürür (2 şarkı olarak faturalanır); örnekte 2 sonuç gösterilmiştir. clips dizisinin uzunluğunu esas alın ve sabit sayıda döngü yazmayın. clips[].song_id değerini kaydedin ve durum completed olana kadar şarkı sorgulama ve geçmiş API'si ile sorgulayın. Sonrasında audio_url ile oynatabilir veya indirebilirsiniz; WAV üretme/alma API'si ve diğer indirme uç noktalarına bakın.

Notlar

• source_clip_id gerçek, tamamlanmış ve geçerli API anahtarıyla erişilebilen bir şarkı kimliği olmalıdır; pending: yer tutucu kimliği kullanılamaz.
• Enstrümantal ekleme cover değildir; cover gerekiyorsa kaynak klipten cover API'sini kullanın.
• Var olan bir şarkıya belirli bir enstrüman veya kanal eklemek için kanal ekleme API'sini kullanın.