Aggiungere musica generata dall'AI a un prodotto significava un tempo licenziare una libreria di stock o assumere un compositore. Nel 2026, puoi chiamare Suno v4.5 e ottenere una canzone completa di 4 minuti con vocali, armonia e produzione — in circa 60 secondi di tempo reale, per meno di $0.50.

Questo post illustra un'integrazione completa, dal primo curl alla consegna audio tramite webhook nella tua app.

1. Ottieni una chiave API

Registrati su aimarcus.eu/aigenerate/register. I $10 gratuiti al momento della registrazione sono sufficienti per ~20 canzoni Suno v4.5 per iniziare.

2. Avvia una generazione

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

Risposta:

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

3. Testi personalizzati

Imposta customMode: true e passa i tuoi testi nel prompt. Suno gestisce melodia, arrangiamento, armonia e performance vocale.

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

Due opzioni:

  • Polling: GET /api/v1/generate/record-info?taskId=... ogni 5 secondi fino a state="success". Gli endpoint di polling sono gratuiti — non contano nel tuo limite di richieste o costi.
  • Webhook: fornisci un callBackUrl. Quando la canzone è pronta, inviamo il risultato JSON al tuo URL con una firma HMAC-SHA256 in X-AI-Signature.

5. Payload finale

Il completamento con successo restituisce due URL audio (Suno genera variazioni):

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

Entrambi sono MP3, 44.1 kHz, pronti per essere riprodotti. Rimangono disponibili agli URL indefinitamente, ma per la produzione dovresti scaricarli e ospitarli sul tuo CDN.

6. Consigli per la produzione

  • Cache sul tuo CDN — gli URL Suno sono veloci ma controlli il tuo SLA quando li ospiti.
  • Archivia il taskId nel tuo database associato alla richiesta dell'utente — rende semplici i retry e gli audit.
  • Imposta un limite di spesa giornaliero nelle impostazioni del dashboard se esponi questa funzione agli utenti finali.
  • Per narrazione parlata in stile podcast, usa invece un modello TTS dedicato (più veloce ed economico di Suno).

Questo è il ciclo completo. Lo stesso schema funziona per Suno v3.5, v4, v4.5 Plus, MusicGen e Mureka — basta cambiare il campo model.