Додавання AI-генерованої музики до продукту раніше означало ліцензування бібліотеки стокової музики або найм композитора. У 2026 році ви можете викликати Suno v4.5 і отримати повноцінну 4-хвилинну пісню з вокалом, гармонією та продакшном — приблизно за 60 секунд реального часу, за менш ніж $0.50.

Ця стаття проводить вас через повну інтеграцію — від першого curl-запиту до доставки аудіо через вебхук у ваш додаток.

1. Отримайте API-ключ

Зареєструйтесь на aimarcus.eu/aigenerate/register. $10 безкоштовно при реєстрації вистачить приблизно на 20 пісень Suno v4.5 для старту.

2. Запустіть генерацію

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

Відповідь:

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

3. Кастомні тексти

Встановіть customMode: true і передайте ваші тексти у prompt. Suno обробляє мелодію, аранжування, гармонію та вокальне виконання.

{
  "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. Опитування або вебхук

Два варіанти:

  • Опитування: GET /api/v1/generate/record-info?taskId=... кожні 5 секунд, поки state="success". Ендпоінти для опитування безкоштовні — вони не враховуються у ваш ліміт запитів і не коштують грошей.
  • Вебхук: надайте callBackUrl. Коли пісня буде готова, ми надішлемо результат JSON на ваш URL з підписом HMAC-SHA256 у X-AI-Signature.

5. Фінальний результат

Успішне завершення повертає два аудіо-URL (Suno генерує варіації):

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

Обидва файли у форматі MP3, 44.1 kHz, готові до відтворення. Вони зберігаються за URL безстроково, але для продакшену рекомендується завантажити їх і розмістити на вашому власному CDN.

6. Поради для продакшену

  • Кешуйте на вашому CDN — URL Suno швидкі, але ви контролюєте свій SLA, коли хостите самі.
  • Зберігайте taskId у вашій базі даних, прив'язуючи до запиту користувача — це спрощує повторні запити та аудит.
  • Встановіть денний ліміт витрат у налаштуваннях дашборду, якщо ви надаєте цю функцію кінцевим користувачам.
  • Для подкастів або озвучення використовуйте спеціалізовану TTS-модель (швидше та дешевше, ніж Suno).

Це повний цикл. Такий самий підхід працює для Suno v3.5, v4, v4.5 Plus, MusicGen і Mureka — просто змініть поле model.