Adăugarea muzicii generate de AI într-un produs însemna, în trecut, licențierea unei biblioteci de stoc sau angajarea unui compozitor. În 2026, poți apela Suno v4.5 și obține o melodie completă de 4 minute cu vocal, armonie și producție — în aproximativ 60 de secunde, pentru mai puțin de $0.50.

Acest articol prezintă o integrare completă, de la primul apel curl până la livrarea audio prin webhook în aplicația ta.

1. Obține o cheie API

Înregistrează-te pe aimarcus.eu/aigenerate/register. Cei $10 oferiți gratuit la înregistrare sunt suficienți pentru ~20 de melodii Suno v4.5 pentru a începe.

2. Lansează o generare

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"
}

Răspuns:

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

3. Versuri personalizate

Setează customMode: true și include versurile tale în prompt. Suno se ocupă de melodie, aranjament, armonie și interpretare vocală.

{
  "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 sau webhook

Două opțiuni:

  • Polling: GET /api/v1/generate/record-info?taskId=... la fiecare 5 secunde până când state="success". Endpoint-urile de polling sunt gratuite — nu se contorizează în limita ta de rată sau cost.
  • Webhook: furnizează un callBackUrl. Când melodia este gata, trimitem un JSON cu rezultatul către URL-ul tău prin POST, cu o semnătură HMAC-SHA256 în X-AI-Signature.

5. Payload final

Finalizarea cu succes returnează două URL-uri audio (Suno generează variații):

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

Ambele sunt MP3, 44.1 kHz, gata de redare. Acestea rămân disponibile la URL pe termen nelimitat, dar pentru producție ar trebui să le descarci și să le găzduiești pe propriul tău CDN.

6. Sfaturi pentru producție

  • Cache pe CDN-ul tău — URL-urile Suno sunt rapide, dar controlezi propriul SLA când găzduiești.
  • Stochează taskId în baza ta de date, asociat cererii utilizatorului — facilitează retry și auditul.
  • Setează un plafon zilnic de cheltuieli în setările dashboard-ului dacă expui această funcționalitate utilizatorilor finali.
  • Pentru narațiuni vorbite, în stil podcast, folosește un model TTS dedicat (mai rapid și mai ieftin decât Suno).

Aceasta este integrarea completă. Același model funcționează pentru Suno v3.5, v4, v4.5 Plus, MusicGen și Mureka — trebuie doar să schimbi câmpul model.