Добавление 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.