Ses efekti üretme API'si

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

Uç nokta açıklaması

Ses efektleri bir şarkı değil, birkaç saniyelik ses üretir. Gök gürültüsü, yağmur damlası veya çarpma sesi gibi kısa sesler için uygundur; geçiş efektleri, ortam sesleri ve davul döngüleri için de kullanılabilir. Çoğu 5 saniyenin altında, en uzunu yaklaşık 20 saniyedir. Tek seferlik ve döngü olmak üzere iki mod desteklenir.

Uç nokta: POST /api/music/sounds

Faturalama: Ücretli, şu anda varsayılan olarak çağrı başına 0,6 CNY. Gerçekte tahsil edilen tutar, mevcut arka ofis fiyat yapılandırmasına göre belirlenir.

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

Parametre	Tür	Zorunlu	Notlar
Authorization	string	evet	Bearer YOUR_API_KEY
Content-Type	string	evet	application/json

Gövde parametreleri

Parametre	Tür	Zorunlu	Varsayılan	Notlar
model	string	hayır	suno-v6	Müşteriye görünen model adı: `suno-v6`, `suno-v6-wild` veya `suno-v6-mini`
description	string	evet	-	İstediğiniz sesi tanımlayın; kısa İngilizce ifadeler en güvenilir sonucu verir, örneğin `cinematic whoosh transition, bright impact`
title	string	hayır	-	Başlık; gönderilmezse açıklamadan üretilebilir
type	string	hayır	one_shot	Tür: `one_shot` (tek seferlik) veya `loop` (döngü)
loop	boolean	hayır	false	Döngüde çalınıp çalınmayacağı; `type` değerini `loop` yapmakla aynıdır
bpm	number	hayır	-	BPM; 0'dan büyük bir sayı olmalıdır. Geçersiz bir değer sessizce yok sayılmak yerine 400 (`invalid_sound_bpm`) döndürür
key	string	hayır	-	Ton, nota adı (C-B) + isteğe bağlı `#`/`b` + isteğe bağlı `Major`/`Minor` biçiminde, örneğin `C Major`, `C#m`, `Bb`; boş veya `any` sınırsız anlamına gelir. Geçersiz bir değer 400 (`invalid_sound_key`) döndürür

İstek örneği

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Yanıt

Bir şarkı dizisi döndürülür; alanlar Yeni API genel bakışı içindeki ortak şarkı yanıt alanlarıyla aynıdır.

SonrakiŞarkı sözü üretme API'si

API anahtarı alın

Kaydolduktan sonra konsoldan bir API anahtarı oluşturun. Her üretim 0,6 ¥ tutarındadır ve 2 parça döner, indirmeler sınırsızdır ve telefon numarası gerekmez.

API anahtarı al Genel bakışa dön