Bir ürüne AI ile üretilmiş müzik eklemek eskiden bir stok kütüphanesi lisanslamak veya bir besteci tutmak anlamına geliyordu. 2026'da, Suno v4.5'i çağırarak vokaller, armoni ve prodüksiyon içeren tam 4 dakikalık bir şarkıyı yaklaşık 60 saniyede, 0.50 dolardan daha ucuza elde edebilirsiniz.

Bu yazı, ilk curl çağrısından uygulamanızda webhook tabanlı ses teslimine kadar tam bir entegrasyonu adım adım anlatıyor.

1. API anahtarı alın

aimarcus.eu/aigenerate/register adresinden kaydolun. Kaydolduğunuzda verilen 10 dolarlık ücretsiz bakiye, başlangıç için yaklaşık 20 Suno v4.5 şarkısı oluşturmanıza yeterlidir.

2. Bir üretim başlatın

POST https://aimarcus.eu/aigenerate/api/v1/generate
Authorization: Bearer sk-aig-YOUR_KEY
Content-Type: application/json

{
  "model": "V4_5",
  "prompt": "Upbeat synthwave, driving bass, retro 80s vibe",
  "customMode": false,
  "instrumental": false,
  "callBackUrl": "https://your-app.com/webhooks/suno"
}

Cevap:

{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }

3. Özel şarkı sözleri

customMode: true ayarını yapın ve şarkı sözlerinizi prompt içinde iletin. Suno melodi, düzenleme, armoni ve vokal performansını üstlenir.

{
  "model": "V4_5",
  "customMode": true,
  "prompt": "[Verse 1]\nWaking up to a city that never sleeps...",
  "style": "indie pop ballad",
  "title": "Midnight City",
  "callBackUrl": "..."
}

4. Polling veya webhook

İki seçenek:

  • Polling: GET /api/v1/generate/record-info?taskId=... her 5 saniyede bir çağrılarak state="success" durumunu bekleyin. Polling uç noktaları ücretsizdir — kota veya maliyet hesabınıza dahil edilmez.
  • Webhook: bir callBackUrl sağlayın. Şarkı hazır olduğunda, sonucu JSON formatında URL'nize HMAC-SHA256 imzasıyla X-AI-Signature başlığı altında POST ederiz.

5. Nihai veri yükü

Başarılı tamamlanma, iki ses URL'si döner (Suno varyasyonlar üretir):

{
  "data": {
    "state": "success",
    "response": {
      "sunoData": [
        { "audioUrl": "https://.../track-a.mp3", "duration": 185 },
        { "audioUrl": "https://.../track-b.mp3", "duration": 194 }
      ]
    }
  }
}

Her ikisi de MP3 formatında, 44.1 kHz ve oynatılmaya hazırdır. URL'ler süresiz olarak erişilebilir durumda kalır, ancak üretim ortamında bunları indirip kendi CDN'inizde barındırmanız önerilir.

6. Üretim ipuçları

  • CDN'inizde önbelleğe alın — Suno URL'leri hızlıdır ancak kendi SLA'nızı kontrol etmek için kendiniz barındırmalısınız.
  • taskId'yi kullanıcı isteğiyle ilişkilendirilmiş olarak veritabanınızda saklayın — bu, yeniden deneme ve denetimi kolaylaştırır.
  • Eğer bu özelliği son kullanıcılara açıyorsanız, kontrol paneli ayarlarında günlük harcama sınırı belirleyin.
  • Podcast tarzı konuşma anlatımları için bunun yerine özel bir TTS modeli kullanın (Suno'dan daha hızlı ve daha ucuzdur).

Tam döngü bu kadar. Aynı desen Suno v3.5, v4, v4.5 Plus, MusicGen ve Mureka için de geçerlidir — sadece model alanını değiştirin.