Prompt önerileri API'si

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

Uç nokta açıklaması

Prompt önerileri uç noktası rastgele şarkı açıklamaları, söz temaları ve stil etiketi önerileri döndürür. "Rastgele ilham" ve "etiketleri yenile" düğmeleri için uygundur.

Uç nokta: POST /api/prompts/suggestions

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.

Kimlik doğrulama

İstek parametreleri

İstek örneği

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Yanıt

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Gece, yeniden buluşma ve pişmanlık üzerine Türkçe sözler yaz"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Alan açıklaması