Stil güçlendirme API'si

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

Uç nokta açıklaması

Stil güçlendirme, kısa bir stil etiketini Suno üretimine daha uygun, daha eksiksiz bir stil açıklamasına genişletir; tam sözlerden bir stil pasajı da üretebilir.

Uç nokta: POST /api/music/boost-style

Faturalama: Kota içinde ücretsiz (kullanıcı başına dakikada en fazla 10, günde en fazla 300 çağrı); ücretsiz kotanın üzerinde çağrı başına 0,1 ¥.

Aşımı algılama: ücretsiz kota aşıldığında istek yine normal çalışır ve yanıt başlıklarında X-Suno-Helper-Free: false ile X-Suno-Helper-Over-Limit: minute (veya day) bulunur; istemci bunu kullanarak bu çağrının ücretlendirildiğini bildirebilir.

Önerilen model: suno-v6. suno-v6, suno-v6-wild ve suno-v6-mini kullanılabilir.

Çince çıktı: istek içeriği (originalTags/lyrics/user_guidance) Çince içeriyor ve dil belirtilmemişse, servis original_tags sonrasına otomatik olarak （请用中文描述） ekler ve user_guidance=语言：简体中文；乐器名也用中文 ifadesini tamamlar; böylece Çince stil açıklamalarının tutma oranı yükselir. Gerçekte gönderilen değerler yanıttaki appliedOriginalTags ve appliedUserGuidance alanlarında döner. Gönderdiğiniz içerikte dil zaten açıkça yazılıysa (örneğin "basitleştirilmiş Çince ile açıkla"), servis hiçbir değişiklik yapmaz.

Kimlik doğrulama

İstek parametreleri

İstek örneği

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nPencerenin ardına gece iniyor\n[Chorus]\nBiz ışığa doğru yürüyoruz",
    "user_guidance": "suona ve erhu ekle, erkek vokal, daha hızlı tempo",
    "instrumental": false
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle, Style giriş kutusuna geri yazılması gereken tam stil açıklamasıdır.