WAV oluşturma/alma API'si

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

Uç nokta açıklaması

WAV uç noktası, var olan bir şarkı için kayıpsız WAV ses adresini oluşturur veya alır.

Uç nokta: POST /api/music/wav

Faturalama: Ücretsiz. Bu uç nokta var olan bir şarkının WAV adresini oluşturur veya alır ve bakiye düşmez.

Bekleme süreleri ve zaman aşımları (önemli): bu uç nokta senkrondur — sipariş ancak yanıt geldiğinde kabul edilir. Ö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. 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

maxAttempts ve intervalSeconds ikisi de JSON sayısıdır; intervalSeconds saniye cinsindendir, milisaniye değildir ve genellikle varsayılan değerler yeterlidir. Bunlar yalnızca bu uç noktanın WAV'ın hazır olmasını içeride kaç kez ve hangi aralıkla bekleyeceğini kontrol eder; üretim görevinin durumunu değiştirmez.

İstek örneği

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Notlar

WAV oluşturma ve sorgulama, sunucu tarafından şarkı kaydına göre otomatik seçilir; müşterinin herhangi bir hesap bilgisi vermesi gerekmez.

Normal şarkılar ve ayrılmış kanallar aynı kontrollü medya teslim yolunu kullanır. WAV önce CN2 tarafından indirilip diske yazılır ve başarılı bir yanıttaki data.wavUrl yalnızca kontrollü bir CDN adresi döndürür — asla geçici bir Suno veya S3 kaynak adresi döndürmez.

ready durumunda bir WAV varlığı zaten varsa yeniden kullanılır; Suno'dan tekrar istenmez ve dosyalar yeniden taşınmaz. Henüz hazırlanmamış bir WAV, /api/music/query üzerinden Suno/S3 adresi olarak açığa çıkarılmaz; yalnızca bu uç nokta veya birleşik indirme uç noktası çağrıldıktan sonra isteğe bağlı olarak hazırlanır.

⚠️ WAV adresinin geçerliliği: 7 gün — zamanında kaydedin. Döndürülen data.wavUrl, platformun nesne depolaması tarafından sunulur ve varsayılan olarak 7 gün sonra geçersiz olur (dosya geri alınır ve eski adres 404 döndürür). WAV'ı bu süre içinde kendi depolamanıza kaydedin; süre dolduktan sonra bu uç noktayı yeniden çağırarak yeni ve geçerli bir adres alabilirsiniz.

Şarkı kaynağı geçici olarak kullanılamıyorsa uç nokta 409 döndürür. Daha sonra tekrar deneyin; sunucu kararsız geçici adresler döndürmez.