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

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

Uç nokta açıklaması

Şarkı sözü üretme, bir tema, var olan söz bağlamı ve stil gereksinimlerinden söz üretir veya yazar. Bu uç nokta en güncel şarkı sözü üretim sözleşmesine yükseltilmiştir ve profesyonel moddaki üretim için doğrudan kullanılabilir.

Uç nokta: POST /api/lyrics/generate

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

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; böylece istemci bu çağrının ücretlendirildiğini bildirebilir.

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

Kimlik doğrulama

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

İstek parametreleri

Parametre	Tür	Zorunlu	Varsayılan	Notlar
model	string	evet	-	Müşteriye görünen model adı: `suno-v6`, `suno-v6-wild` veya `suno-v6-mini`
instruction	string	evet	-	Söz teması veya üretim gereksinimi
style	string	hayır	-	Stil gereksinimi
title	string	hayır	-	Şarkı başlığı veya başlık kısıtı
selected	string	hayır	`""`	Yeniden yazılacak seçili metin
context_before	string	hayır	`""`	Önceki bağlam
context_after	string	hayır	`""`	Sonraki bağlam
mode	string	hayır	`apply_user_request`	Şarkı sözü üretim modu
references	array	hayır	`[]`	Referans materyal listesi
num_variants	integer	hayır	`null`	İstenen söz varyantı sayısı
lyricist_id	string	hayır	`null`	Belirli bir söz yazarı kimliği (söz yazarı listesi kapatıldı; yeni entegrasyon önerilmez)
metadata	object	hayır	-	Genişletilmiş parametreler; `lyrics_model` ve `enable_thinking` desteklenir
lyrics_project_id	string	hayır	`null`	Var olan bir söz projesi kimliği (söz projesi serisi kapatıldı; yeni entegrasyon önerilmez)

instruction, eski theme ve prompt alanlarını da kabul eder. metadata.lyrics_model varsayılan olarak default, metadata.enable_thinking varsayılan olarak false değerindedir.

Dil denetimi

Bu uç noktada ayrı bir language istek alanı yoktur. Sözün dili instruction içeriğiyle belirlenir; style yalnızca destekleyici bir rol oynayabilir.

Çince söz üretmek için hedef dili instruction içinde açıkça belirtin, örneğin:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

"Write the lyrics in Chinese about ..." de yazabilirsiniz. İngilizce söz için "请用英文写歌词" ya da "Write the lyrics in English" yazın. Yalnızca İngilizce tema verip hedef dili belirtmezseniz sonuç İngilizce olabilir.

İstek örneği

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Mezuniyet dönemi ve yeniden başlamak üzerine Türkçe sözler",
    "style": "pop rock, içten, akılda kalan nakarat",
    "title": "Yeniden başlamak",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nRüzgâr okul bahçesinden geçiyor\nDüne el sallıyoruz",
    "edited_lyrics": "[Verse]\nRüzgâr okul bahçesinden geçiyor\nDüne el sallıyoruz",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics, söz kutusuna yazılması gereken tam söz metnidir. lyrics_id ve lyrics_request_id izleme içindir ve uç noktanın dönüşüne göre boş olabilir; bunları şarkı kimliği olarak görmeyin.

Uyumluluk notları

Eski theme ve prompt alanları hâlâ çalışır ve instruction değerine eşlenir.
"Söz projesi / söz yazarı" uç nokta serisi kapatıldı: üretilen sonuçları saklamanız gerekiyorsa uç noktanın döndürdüğü edited_lyrics değerini kendiniz kaydedin.

SonrakiSes klonlama ve belirtilen sesle üretim API'si (önerilmez)

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