AI:lla tuotetun musiikin lisääminen tuotteeseen tarkoitti aiemmin varastokirjaston lisensointia tai säveltäjän palkkaamista. Vuonna 2026 voit kutsua Suno v4.5:tä ja saada täyden 4-minuuttisen kappaleen lauluineen, harmonioineen ja tuotantoineen — noin 60 sekunnissa, alle $0.50 hintaan.

Tässä postauksessa käydään läpi täydellinen integraatio ensimmäisestä curl-kutsusta webhook-pohjaiseen äänentoimitukseen sovelluksessasi.

1. Hanki API-avain

Rekisteröidy osoitteessa aimarcus.eu/aigenerate/register. Ilmaiset $10 rekisteröitymisen yhteydessä riittävät noin 20 Suno v4.5 -kappaleeseen aloitusta varten.

2. Käynnistä generointi

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

Vastaus:

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

3. Mukautetut sanoitukset

Aseta customMode: true ja anna sanoituksesi promptissa. Suno hoitaa melodian, sovituksen, harmonian ja laulusuorituksen.

{
  "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. Kysely tai webhook

Kaksi vaihtoehtoa:

  • Kysely: GET /api/v1/generate/record-info?taskId=... joka 5. sekunti, kunnes state="success". Kyselypisteet ovat ilmaisia — ne eivät kuluta rajoitustasi tai maksa mitään.
  • Webhook: anna callBackUrl. Kun kappale on valmis, POSTaamme tulos-JSON:in URL-osoitteeseesi HMAC-SHA256-allekirjoituksella X-AI-Signature-otsikossa.

5. Lopullinen vastaus

Onnistunut suoritus palauttaa kaksi äänitiedoston URL-osoitetta (Suno tuottaa variaatioita):

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

Molemmat ovat MP3-muodossa, 44,1 kHz, valmiina toistettavaksi. Ne säilyvät URL-osoitteessa toistaiseksi, mutta tuotannossa sinun tulisi ladata ja isännöidä ne omalla CDN:lläsi.

6. Tuotantovinkit

  • Välimuista CDN:lläsi — Suno-URL-osoitteet ovat nopeita, mutta hallitset oman SLA:n, kun isännöit itse.
  • Tallenna taskId tietokantaasi käyttäjäpyyntöön liittyen — helpottaa uudelleenkäsittelyä ja auditointia.
  • Aseta päivittäinen kulutuskatto hallintapaneelin asetuksissa, jos altistat tämän loppukäyttäjille.
  • Podcast-tyyliseen puhutun kerronnan tuottamiseen käytä mieluummin erillistä TTS-mallia (nopeampi ja halvempi kuin Suno).

Tässä koko prosessi. Sama malli toimii Suno v3.5:lle, v4:lle, v4.5 Plus:lle, MusicGenille ja Murekalle — muuta vain model-kenttä.