Replace Section API (bölümü değiştirme)

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

Uç nokta açıklaması

Replace Section, var olan bir şarkının bir zaman aralığını yerinde yeniden üretir. Bir söz satırını düzeltmek veya bir pasajı değiştirmek için uygundur.

Uç nokta: POST /api/music/replace-section

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

startSeconds ve endSeconds saniye cinsindendir ve ondalık kabul eder; startSeconds, endSeconds değerinden küçük olmalı ve aralık orijinal şarkının süresi içinde kalmalıdır. requestedAt yalnızca istek zamanını iletmeniz gerektiğinde kullanılır; birimi Unix saniye zaman damgasıdır (milisaniye değil) ve normalde atlanabilir.

Değiştirme de asenkron bir görevdir. Dönen clip pending durumuyla başlayabilir ve o anda ses adresinin boş olması normaldir; nihai sonucu sorgulamak için dönen gerçek song_id değerini kullanın.

Bölüm uzunluğu: en az 2 saniye (önemli)

Değiştirilecek aralık 2 saniyeden kısa olamaz. Ölçüm: 1,0 / 1,2 / 1,5 saniyelik aralıkların hepsi başarısız oldu, 2,0 saniye ve üzeri çalıştı.

Aralık çok kısaysa platform "parametre hatası" değil, yanlış anlaşılması kolay bir mesaj döndürür:

{"error":{"message":"You don't have access to this model. Upgrade your plan to use it.",
          "type":"bad_response_status_code","code":"bad_response_status_code"}}

Bu cümle bir hesap veya paket sorunu değildir — bölüm çok kısadır. Aralığı 2 saniyenin üzerine çıkarıp yeniden gönderin.

İstek örneği

curl -X POST https://www.suno-api.io/api/music/replace-section \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "startSeconds": 30,
    "endSeconds": 45,
    "contextLyrics": "tam bağlam sözleri",
    "contextWindowLyrics": "pencere bağlamı sözleri",
    "infillLyrics": "değiştirme sonrası sözler",
    "style": "Mandopop, acoustic",
    "title": "Değiştirilmiş sürüm",
    "negativeTags": "noise"
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "replace_clip_id",
        "song_title": "Değiştirilmiş sürüm",
        "status": "pending"
      }
    ],
    "replaceTask": "infill",
    "clipId": "clip_id",
    "source_update": {}
  }
}

Uyumlu alanlar

• audioId / audio_id / clipId / clip_id
• startSeconds / start_seconds / infillStartS / infill_start_s
• endSeconds / end_seconds / infillEndS / infill_end_s
• infillLyrics / infill_lyrics / replacementLyrics / replacement_lyrics
• style / tags
• negativeTags / negative_tags