Az AI által generált zene hozzáadása egy termékhez korábban azt jelentette, hogy licencelni kellett egy zenei könyvtárat, vagy fel kellett venni egy zeneszerzőt. 2026-ban elég meghívni a Suno v4.5-öt, és körülbelül 60 másodperc alatt, kevesebb mint $0.50-ért elkészül egy teljes, 4 perces dal vokállal, harmóniával és produkcióval.
Ez a bejegyzés végigvezet egy teljes integráción, az első curl-hívástól kezdve a webhook-alapú hanganyag kézbesítéséig az alkalmazásodban.
1. Szerezz API-kulcsot
Regisztrálj a következő címen: aimarcus.eu/aigenerate/register. Az ingyenes $10 kezdőegyenleg körülbelül 20 Suno v4.5 dal generálására elegendő.
2. Indítsd el a generálást
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"
}
Válasz:
{ "code": 200, "data": { "taskId": "f0147a2e78670ecbce46020219f931a1" } }
3. Egyedi szövegek
Állítsd be a customMode: true értéket, és add meg a szövegedet a promptban. A Suno kezeli a dallamot, hangszerelést, harmóniát és a vokális előadást.
{
"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. Lekérdezés vagy webhook
Két lehetőség:
- Lekérdezés:
GET /api/v1/generate/record-info?taskId=...minden 5 másodpercben, amígstate="success". A lekérdezési végpontok ingyenesek — nem számítanak bele a sebességkorlátba vagy költségbe. - Webhook: adj meg egy
callBackUrl-t. Amikor a dal elkészül, a rendszer POST-olja az eredmény JSON-t az URL-edre egy HMAC-SHA256 aláírással azX-AI-Signaturefejlécben.
5. Végső válasz
Sikeres befejezés esetén két hangfájl URL-t kapsz (a Suno variációkat generál):
{
"data": {
"state": "success",
"response": {
"sunoData": [
{ "audioUrl": "https://.../track-a.mp3", "duration": 185 },
{ "audioUrl": "https://.../track-b.mp3", "duration": 194 }
]
}
}
}
Mindkettő MP3, 44,1 kHz, azonnal lejátszható. Az URL-ek határozatlan ideig elérhetők, de produkciós környezetben érdemes letölteni és saját CDN-re feltölteni őket.
6. Produkciós tippek
- Tárold a fájlokat a saját CDN-eden — a Suno URL-ek gyorsak, de a saját SLA-dat te irányítod, ha te hostolod.
- Mentsd el a
taskId-t az adatbázisodban a felhasználói kéréshez kapcsolva — ez megkönnyíti az újrapróbálkozást és az auditot. - Állíts be napi költési limitet a vezérlőpult beállításaiban, ha ezt a funkciót végfelhasználók számára is elérhetővé teszed.
- Podcast-stílusú narrációhoz használj dedikált TTS modellt (gyorsabb és olcsóbb, mint a Suno).
Ez a teljes folyamat. Ugyanez a minta működik a Suno v3.5, v4, v4.5 Plus, MusicGen és Mureka esetében is — csak a model mezőt kell módosítani.