Extend API (uzatma)

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

Uç nokta açıklaması

Extend, var olan bir şarkıyı seçilen bir andan itibaren sürdürür ve sonraki bölümü üretir.

Uç nokta: POST /api/music/extend

Faturalama: Ücretli, şu anda varsayılan olarak çağrı başına 0,6 ¥. Gerçekte tahsil edilen tutar güncel 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ı 2 kat fiyattan faturalanır (0,6 → 1,2 ¥ / çağrı); variety için ek ücret alınmaz. Anlamları ve nasıl gönderilecekleri Yeni API genel bakışı sayfasındaki "Gelişmiş parametreler" bölümündedir.

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.

İstek parametreleri

Headers

Gövde parametreleri

İstek örneği

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "nakarata daha yoğun bir duyguyla devam et",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Uzatılmış sürüm",
    "waitAudio": false
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Uzatılmış sürüm",
        "status": "pending"
      }
    ]
  }
}

Uyumlu alanlar

Eski alan adları hâlâ kabul edilir:

Notlar

• Başlangıcı sona yapıştırmayın: uzatmanın uzunluğu esas olarak "başlangıç noktasından sonra kalan kısım" kadardır. Başlangıç noktası sona çok yakınsa sonuç yalnızca birkaç saniye olur — ölçümde 242 saniyelik bir şarkı 240. saniyeden uzatıldığında yalnızca 2,7 saniye üretildi (ve çağrı yine faturalanır). Başlangıç noktasından sonra en az 10 saniye bırakın.
• Extend'te "kaynak çok kısa" eşiği yoktur: ölçümde 9,6 saniyelik kısa bir kaynak 5. saniyeden uzatıldığında da normal şekilde şarkı üretti; kısa kaynak veya kısa kalan kısım reddedilme nedeni değildir.
• Başlangıç noktası 0'dan büyük olmalıdır: continueAt=0 platform tarafından kabul edilip sonra geçersiz kılınır ve başarısızlık nedeni döndürülmez; bu yüzden ilk saniyeden hemen sonra başlayın.
• Bir çağrı 2 sonuç döndürür (2 şarkı olarak faturalanır); clips dizisinin uzunluğuna bakın.
• Sonuç yeni bir eserdir; orijinal şarkı etkilenmez.