Kimlik doğrulama

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

Suno-API'ye yapılan tüm istekler bir API anahtarıyla doğrulanır. Bu sayfada anahtarın nasıl oluşturulacağı, nasıl gönderileceği, hataların ne anlama geldiği ve anahtarın nasıl güvenli tutulacağı anlatılır.

API anahtarı nedir

Anahtar, hesabınıza bağlı bir bearer token'dır. Bakiyeyi taşır; yani anahtarı ele geçiren kişi bakiyeyi harcayabilir. Anahtar oluşturulurken yalnızca bir kez gösterilir: kopyalayın ve güvenli bir yerde saklayın.

Anahtar oluşturma

1. https://www.suno-api.io adresine kaydolun — yalnızca e-posta, telefon numarası gerekmez.
2. Konsolda token yönetimini açın.
3. Yeni bir anahtar oluşturun ve kopyalayın.

Anahtarlar sk-… biçimindedir. Kaybolan anahtar kurtarılamaz: yenisini oluşturup eskisini silin.

Anahtarı kullanma

Başlık biçimi

Anahtarı her istekte Authorization başlığında gönderin:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Örnek

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "bir kafe için sakin piyano parçası"}'

Kimlik doğrulama hataları

401 Unauthorized

Başlık yok, bozuk ya da anahtar mevcut değil.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Başlığın tam olarak Bearer <anahtar> biçiminde olduğundan (Bearer sonrasında boşluk) ve anahtarın sonuna satır sonu karakteri kaçmadığından emin olun.

403 Forbidden

Anahtar var ama bu isteği yapmaya yetkili değil — çoğunlukla anahtar devre dışı bırakıldığı veya hesap askıya alındığı için. Konsoldan hesap durumunu kontrol edin, neden açık değilse destekle iletişime geçin.

Güvenlik için en iyi uygulamalar

Anahtarı asla istemci koduna koymayın

Anahtarı web sayfalarına, mobil uygulamalara veya masaüstü programlarına gömmeyin. Tarayıcı denetçisini açabilen herkes anahtarı okuyup bakiyenizi harcayabilir. API'yi kendi sunucunuzdan çağırın ve kullanıcılarınıza kendi uç noktanızı sunun.

Ortam değişkenlerini kullanın

Linux / macOS

# ~/.bashrc veya ~/.zshrc
export SUNO_API_KEY="sk-your-key-here"

# Python
import os
api_key = os.environ["SUNO_API_KEY"]

.env

# .env dosyası — .gitignore dosyasına ekleyin
SUNO_API_KEY=sk-your-key-here

Windows

setx SUNO_API_KEY "sk-your-key-here"

Node.js

require('dotenv').config();
const apiKey = process.env.SUNO_API_KEY;

Gerektiğinde anahtarı değiştirin

Anahtarları 3-6 ayda bir, sızıntı şüphesinde ise hemen değiştirin. Artık kullanmadığınız anahtarları silin: kullanılmayan anahtar yalnızca kullanılmayan bir risktir.

İstek limiti

İstekler anahtar başına sınırlandırılır:

429 Too Many Requests

Bir sınırı aştığınızda API 429 döner ve yanıt saniye cinsinden bir retry_after değeri içerebilir. Bir sonraki denemeden önce o kadar bekleyin; istek hızını düşürün, işi kuyruğa alın veya sıkı bir döngü yerine üstel geri çekilmeyle yeniden deneyin.

Yeniden deneme politikası

Yalnızca açık hatalarda yeniden deneyin. Okuma veya bağlantı zaman aşımından sonra yeniden denemeyin: üretim uç noktaları senkrondur, bu yüzden zaman aşımı siparişin çoktan kabul edilip üretiliyor olması anlamına gelebilir — yeniden denemek mükerrer sipariş oluşturur ve iki kez ücret alır. İstemci zaman aşımını 300 saniye veya üzerine ayarlayın ve bağlantı koptuysa yeniden göndermeden önce siparişi GET /api/music/songs ile doğrulayın. Yeni API genel bakışı sayfasındaki "Bekleme süreleri ve zaman aşımı ayarları" bölümüne bakın.

Sıkı bir döngü yerine üstel geri çekilmeyle yeniden deneyin:

import time

delay = 1.0
for attempt in range(5):
    response = call_api()
    if response.status_code != 429:
        break
    time.sleep(delay)
    delay *= 2

Sık sorulan sorular

Anahtarın biçimi nedir?

sk- ile başlar, ardından harf ve rakamlar gelir; toplamda yaklaşık 50-60 karakterdir.

API'yi doğrudan tarayıcıdan çağırabilir miyim?

Teknik olarak evet, ancak üretimde yapmayın: anahtar tüm ziyaretçiler tarafından görülür. İstekleri kendi arka ucunuz üzerinden proxy'leyin.

Anahtarın hâlâ geçerli olduğunu nasıl anlarım?

Kimlik doğrulamalı herhangi bir istek gönderin. 200 çalıştığını, 401 ise anahtarın geçersiz veya silinmiş olduğunu gösterir.

Anahtarı kaybettim. Ne yapmalıyım?

Anahtarlar kurtarılamaz. Konsoldan yeni bir tane oluşturup eskisini silin.

Bir hesabın kaç anahtarı olabilir?

Sabit bir üst sınır yoktur. Uygulama veya ortam başına bir anahtar kullanın ki ayrı ayrı iptal edebilesiniz; kullanmadıklarınızı silin.

Anahtarların süresi dolar mı?

Siz silene veya hesabı kapatana kadar geçerlidir. Düzenli aralıklarla değiştirmek iyi bir uygulamadır.

Kullanımı nasıl izlerim?

Konsola giriş yapın: anahtar başına kullanım orada listelenir (istek sayısı, harcama ve son görevler).

İlgili sayfalar

• Hızlı başlangıç
• Desteklenen modeller