Remaster API'si

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

Uç nokta açıklaması

Remaster, tamamlanmış bir şarkıyı daha iyi ses kalitesine sahip "remaster sürümü" olarak yeniden üretir. Tek seferde 2 sürüm döndürür ve upstream başlığa otomatik olarak (Remastered) ekler.

Uç nokta: POST /api/music/remaster

Faturalama: Ücretli, istenen modele göre faturalanır (varsayılan suno-v6, çağrı başına 0,6 CNY); gerçekte tahsil edilen tutar arka ofis fiyat yapılandırmasına göre belirlenir.

Model hakkında: remaster, platformun sabitlediği ayrı bir upstream uç noktası ve ayrı bir remaster modeli kullanır ve model değerine göre değişmez; istekteki model yalnızca fiyat ve kanal seçimi için kullanılır, bu yüzden suno-v6 değerini açıkça göndermeniz önerilir.

Bekleme süreleri ve zaman aşımları (önemli): bu uç nokta senkrondur — sipariş ancak yanıt geldiğinde kabul edilir ve remaster'a verilir. İstemci zaman aşımını 300 saniye veya üzerine ayarlayın; yanıt gelmemesi hiçbir şeyin remaster edilmediğ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.

Kimlik doğrulama

İstek parametreleri

audio_id, source_clip_id ve sourceClipId, song_id için eşdeğer yazımlardır; herhangi birini kullanın.

İstek örneği

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Varsayılan değerler yeterliyse yalnızca kaynak şarkıyı gönderin — bu variation_category: normal + style_profile: boost ile aynıdır:

{ "model": "suno-v6", "song_id": "source_song_id" }

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Kaynak şarkı adı (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Kaynak şarkı adı (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Bir çağrı 2 remaster sürümü döndürür. İki clips[].song_id değerini de kaydedin, ardından sesi almadan önce şarkı sorgulama ve geçmiş API'si ile complete olana kadar sorgulayın.

Notlar

• Kaynak şarkı tamamlanmış olmalı ve geçerli API anahtarının erişim kapsamında bulunmalıdır; harici kaynak malzeme çalıştıran hesaba otomatik olarak eşitlenir.
• Remaster yalnızca ses kalitesini yeniler: stil, düzenleme veya vokali değiştirmek için stil güçlendirme, yükle ve cover yap veya Remix uç noktalarını kullanın.
• variation_category büyüdükçe remaster sürümü kaynak şarkıdan daha çok farklılaşır; gerçek teslimattan önce normal ile deneyip sonra yükseltmeniz önerilir.