Suno API belgeleri — bir istemden müzik oluşturma (V5 / V5.5), fiyatlandırmayla birlikte

Suno, sınıfının en iyisi bir yapay zekâ müzik modelidir — bir metin prompt'undan vokal, söz ve enstrümantasyon içeren tam şarkılar üretir. Suno API (Kunavo'da Suno V5 ve V5.5), bunu POST /v1/audio/music üzerinden programatik olarak yapar ve tek bir bearer token ile barındırılan ses parçaları döndürür. Bu, pratik belgelendirmedir: istek yapısı, fiyatlandırma ve üretim ortamı için asenkron model.

Suno API'yi çağırın

/app/keys adresinden bir anahtar oluşturun ve bir prompt POST edin. Tek bir istek yaklaşık iki parça varyasyonu döndürür; üretim onlarca saniyeden birkaç dakikaya kadar sürer:

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Tüm parametreler ve asenkron görev yaşam döngüsü müzik API referansında yer alır.

Fiyatlandırma

Suno, parça başına değil üretim isteği başına ücretlendirilir; bu nedenle aldığınız yaklaşık 2 varyasyon tek bir ücret oluşturur. Güncel fiyatlar her model sayfasında yer alır. Suno kendisi istek başına API fiyatı yayımlamaz — kendi API'si herkese açık fiyatı olmayan, yalnızca iş ortaklarına açık bir programdır — bu nedenle tablo yalnızca Kunavo'nun ücretlendirdiğini gösterir.

$10 minimum yüklemeyle kullanım kadar ödeyin; bakiye hiçbir zaman sona ermez, başarısız üretimler hiçbir zaman ücretlendirilmez. Daha geniş bir iş yükünü maliyet hesaplayıcıyla tahmin edin.

Özel mod: kendi sözleriniz

Basit bir prompt yerine tam kontrol için lyrics, bir style açıklaması ve bir title sağlayın veya vokalleri tamamen atlamak için instrumental: true ayarını yapın:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Üretimde eşzamansız kullanım

Müzik üretimi anında gerçekleşmez; bu nedenle ölçekli kullanımda bağlantıyı açık tutmak yerine bir görev gönderin ve sonucu yoklayın — müzik belgeleri görev yaşam döngüsünü, yoklamayı ve webhook teslimini açıklar. Sonuç URL'leri tamamlandıktan sonra kalıcıdır.

Kunavo ve doğrudan Suno kullanımı

Suno'nun kendi ürünü, ölçümlü kullanım kadar ödemeli bir API değil, kredi hakkı içeren bir aboneliktir — geliştiricilerin en başta "Suno API" aramasının temel nedeni de budur:

Bir ürün içinde müzik üretiyorsanız ölçümlü faturalandırma ve gerçek bir uç nokta önemlidir. Bir insan tarayıcıda elle parça oluşturuyorsa Suno'nun kendi aboneliği daha basit bir satın alımdır.

Suno API ve Udio API karşılaştırması

Udio, diğer önde gelen müzik üretimi ailesidir ve "Udio API" yaygın bir paralel aramadır. Bugünkü pratik fark şudur: Udio API erişimi, istikrarlı bir herkese açık fiyatı olmayan deneysel üçüncü taraf yollar üzerinden çalışırken, Kunavo'daki Suno V5 / V5.5 sabit ve yayımlanmış bir ücretle (üretim isteği başına $0,09) desteklenen bir uç noktadır. Üretim ortamında güvenilir müzik üretimine ihtiyacınız varsa — buradaki Suno V5 API güvenilir yoldur; istikrarlı bir upstream mevcut olduğunda Udio'yu değerlendireceğiz.

Müziğin ötesinde

Aynı anahtar metne (Claude, GPT), görüntüye (Nano Banana, GPT-Image-2) ve videoya (Veo 3, Seedance 2, Wan 2.7) erişir — böylece eksiksiz bir iş akışını zincirleyebilirsiniz: bir LLM ile senaryo yazın, görseller üretin, Suno müziği ekleyin. Görüntü → video → müzik iş akışları için çok modlu yapay zekâ kılavuzuna bakın.

Sık sorulan sorular