Suno API: resmî durum, API anahtarları ve Python örneği

17 Ekim 2026 itibarıyla Suno'nun resmî bir API'si var, ama kayıt olunamıyor: platform.suno.com yalnızca mevcut API hesapları için giriş sunuyor; herkese açık doküman, fiyat ya da self-servis erişim yok. Suno temmuzda seçilmiş bir ortak grubuyla başladığını söyledi. Davet olmadan bugün iki başka seçenek çalışıyor.

Suno'nun resmî API'si var mı?

Suno, platform.suno.com üzerinde bir API pazarlıyor ve bu tek sayfa onun tüm kamuya açık yüzü.

Başlık “a simple REST API” arkasında “original songs, covers, and mashups from a single prompt” vaat ediyor ve sayfadaki tek işlem, Suno hesabınıza bağlı Google hesabıyla ya da e-postayla gelen kodla giriş yapmak. Diğer bağlantılar suno.com, Terms ve Privacy; başka bir şey yok. Aynı alan adındaki /docs ve /pricing de aynı giriş kutusunu döndürüyor (17 Ekim 2026'da kontrol edildi). Yani API var, ama dokümanı ve fiyatları ancak giriş yaptıktan sonra görünüyor.

Ortak çağrısı Music Business Worldwide'den biliniyor: 2 Temmuz 2026'da yayımlanan habere göre Suno'nun ürün direktörü Jack Brody, planları 1 Temmuz'da bir LinkedIn gönderisinde duyurdu ve bir başvuru formuna bağlantı verdi. Haberin aktardığı forma göre metin şöyle: “We're beginning to explore a developer API, starting with a curated group of partners.” Yani Suno, geliştirici API'sini seçilmiş bir ortak grubuyla keşfetmeye başlıyor. Çıkış tarihi açıklanmadı; platform sayfası, sürüm notları ve Suno'nun yardım merkezi de bir tarih eklemiyor.

Kurumsal alıcılar için yol satış ekibinden geçiyor: Suno'nun Şartları'nda “if you are an enterprise user, you must contact sales to use our Service” yazıyor. Aynı haber, Suno'nun “has not released self-serve developer access or published its own API documentation” olduğunu not ediyor; bu da sayfanın ekimde hâlâ gösterdiğiyle örtüşüyor.

Bugün Suno'yu koddan çağırmanın üç yolu

Resmî ortak erişimi. Brody'nin temmuzda bağlantı verdiği form, Suno'nun gösterdiği tek kapı ve haber, genel kayıt yerine seçilmiş bir ortak grubu için erken erişim anlatıyor. 17 Ekim 2026'da platform sayfasında yalnızca giriş kutusu var; form, bekleme listesi ya da erişim talebi bağlantısı yok ve Suno'nun kendi sayfalarında forma giden herkese açık bir bağlantı bulamadık. Music Business Worldwide daha geniş bir çıkış için tarih vermedi.

Resmî olmayan GitHub sarmalayıcısı. gcui-art/suno-api en bilinen geçici çözüm: 17 Ekim 2026'da 3.259 yıldız ve yaklaşık 100 açık issue, son commit 6 Mart 2026. README, resmî API'nin “is not yet available” olduğunu söylüyor ve üç şey istiyor: kendi Suno hesabınızın çerezi, tarayıcının ağ sekmesinden elle kopyalanmış; ücretli bir 2Captcha anahtarı, çünkü Suno hCaptcha doğrulamaları göstermeye devam ediyor; ve rebrowser yamalarıyla Playwright üzerinden sürülen gerçek bir tarayıcı. 14 Aralık 2025'te açılan #262 numaralı issue'da yazar “lacks the time to maintain it” diyor.

10 Ağustos 2026'da son kez revize edilen ve 3 Eylül 2026'da yürürlüğe giren Suno Kullanım Şartları “any data mining, robots, scraping, or similar data gathering or extraction methods” yöntemlerini ve içeriğin “through any means not intentionally made available or provided for through the Service” yollarla elde edilmesini yasaklıyor. suno.com'u kendi çerezinizle süren bir sarmalayıcı üzerine ürün kurmadan önce bu iki maddeyi Suno Şartları sayfasında okuyun. README'nin kendisinde bu konuda uyarı yok; tek hukuki satırı LGPL-3.0 lisansı.

Üçüncü taraf API platformu. OmniaKey üçüncü taraf bir API platformu, Suno değil. Suno v4.5 ve Suno v6 modellerine kendi asenkron medya API'si üzerinden erişim satıyor; anahtarı OmniaKey veriyor ve faturalıyor. Dokümanlar tam olarak iki model kimliği listeliyor, suno-v4.5 ve suno-v6, ve her istek bir bitmiş, mikslenmiş şarkı döndürüyor; Suno hesabı ise iki alternatif gösteriyor. Aşağıda baştan sona çalıştırdığımız seçenek bu.

Python ile şarkı üretmek

Bir istek görevi oluşturuyor, ikinci çağrı durumu kontrol ediyor ve bitmiş MP3 imzalı bir bağlantıyla geliyor. Anahtarı ortam değişkenine yazın, betiği suno_song.py olarak kaydedin ve çalıştırın; betik status alanını 5 saniyede bir sorguluyor, çünkü progress.percent yaklaşık bir değer ve görev sürerken 0'da kalabiliyor.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Create the job. Reuse the same Idempotency-Key only when retrying this exact request.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Poll on status, not on progress.percent, until the job finishes.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Download the MP3 now: the signed URL expires in about an hour.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Aynı betiği 17 Ekim 2026'da çalıştırdık ve iki satır yazdırdı:

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Başlangıçtan kaydedilen dosyaya 82 saniye geçti. Dosya 48 kHz stereo bir MP3, yaklaşık 161 kbps, 2:55 uzunluğunda, 3,5 MB ve enstrümantal, çünkü betik instrumental değerini true yapıyor.

İki modeli iki giriş modunda karşılaştırmak için 17 Ekim 2026'da 13:03 UTC'den itibaren OmniaKey API'si üzerinden dört şarkı daha ürettik ve durumu 4 saniyede bir sorguladık.

Dördü de ilk denemede bitti ve her istek bir MP3 döndürdü. Bir açıklama yaklaşık üç dakikalık tam bir şarkı üretti; aynı stil kendi yazdığımız sekiz satır sözle 45–63 saniyede döndü, yani sözleri kendiniz yazdığınızda kısa bir parça bekleyin. Bit hızları 48 kHz stereoda 151 ile 195 kbps arasındaydı ve imzalı indirme bağlantıları her görevin oluşturulmasından yaklaşık bir saat sonra sona erdi.

Parametreler ve sınırlar

• Boş olmayan bir input.lyrics özel söz moduna geçer; bu modda input.prompt, parameters.style veya parameters.tags stili anlatır. Ne prompt ne söz içeren görev reddedilir.
• suno-v6 model kimliğiyle seçilir ve mv gerektirmez; mv yalnızca v4.5 için geçerli.
• Yalnızca generate sunuluyor. Uzatma, ayrı söz ve konuşma sentezi 503 no_available_channel ile başarısız oluyor ve ön tahsilat geri geliyor.
• Bir istek bir bitmiş şarkı, bu yüzden parameters.n 1 olmalı.
• Dosya bağlantıları imzalı ve kısa ömürlü, yaklaşık bir saat; görev kayıtları oluşturulduktan sonra 24 saat saklanıyor.

Hatalar ve iadeler

Başarısız olan, iptal edilen veya sağlayıcıya hiç ulaşmayan görev otomatik iade edilir; iptal edildikten sonra yine de tamamlanan görev ise bittiği duruma göre ücretlendirilir. Aynı idempotency anahtarını aynı gövdeyle tekrar göndermek ikinci bir görev oluşturmak yerine özgün görevi 200 ile döndürür, böylece zaman aşımından sonraki tekrar yalnızca bir kez ücretlendirir. Kurtarma bu yüzden kısa: oluşturma zaman aşımına uğrarsa aynı gövdeyi ve anahtarı yeniden gönderin; görev kimliğini aldıktan sonra sorgulamaya devam edin.

Sık sorulan sorular

Ücretsiz Suno API var mı?

Suno, platform.suno.com üzerinde ücretsiz bir API katmanı yayımlamıyor. Ücretsiz planlar suno.com uygulamasında: v6-mini herkese açık ve v4.5-all varyantı 21 Ekim 2025'ten beri ücretsiz. Ücretsiz katmanda üretilen çıktı yalnızca kişisel, ticari olmayan kullanım içindir.

Suno API ile üretilen şarkıları ticari olarak kullanabilir miyim?

Suno Şartları Output'u Pro ve Premier abonelerine devrediyor ve ticari kullanıma yalnızca “downloaded by you through an approved channel”, yani onaylı bir kanaldan sizin indirdiğiniz Output için izin veriyor. Ücretsiz katmanın çıktısı ticari olmayan kalır ve remiksler hangi plan olursa olsun yalnızca kişisel kullanım içindir. Üçüncü taraf API'den gelen şarkılar da istisna değil; üretilen bir şarkıyı ücretli bir ürüne koymadan önce Suno Şartları'nı okuyun.

Bir şarkı ne kadar sürer?

Ses dokümanları üretim için yirmi saniye ile iki dakika arası veriyor. Dört görevimiz 70 ile 105 saniye sürdü, betik çalışması başlangıçtan kaydedilen dosyaya 82 saniye aldı.

v4.5 mi, v6 mı kullanmalıyım?

Suno v6 ailesini 9 Eylül 2026'da, v4.5'i 1 Mayıs 2025'te duyurdu. v6 yalnızca model kimliğiyle seçiliyor; v4.5 ise sürümü sabitlemek için parameters.mv alıyor ve OmniaKey'in suno-v4.5 kimliği hangi v4.5 varyantına denk geldiğini söylemiyor. Suno v6'yı amiral gemisi modeli olarak adlandırıyor; eski bir v4.5 sürümünü sabitlemeniz gerekmiyorsa Suno v6 ile başlayın.

Suno API anahtarını nasıl alırım?

API hesabınız zaten varsa platform.suno.com adresine Suno hesabınıza bağlı Google hesabıyla ya da e-postayla gelen kodla giriş yapın. Hesabınız yoksa temmuzdaki ortaklık formu tek herkese açık kapıydı ve bugün sayfada yok. OmniaKey gibi üçüncü taraf bir platform, herhangi bir Suno girişinden bağımsız kendi anahtarını veriyor.