Dodanie muzyki generowanej przez AI do produktu kiedyś oznaczało licencjonowanie biblioteki stockowej lub zatrudnienie kompozytora. W 2026 roku możesz wywołać Suno v4.5 i uzyskać pełny, 4-minutowy utwór z wokalem, harmonią i produkcją — w około 60 sekund czasu rzeczywistego, za mniej niż $0.50.

Ten post przeprowadzi Cię przez kompletną integrację, od pierwszego curl do dostarczania audio przez webhook w Twojej aplikacji.

1. Uzyskaj klucz API

Zarejestruj się na aimarcus.eu/aigenerate/register. $10 darmowych środków na start wystarczy na około 20 utworów Suno v4.5.

2. Rozpocznij generację

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

Odpowiedź:

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

3. Niestandardowe teksty

Ustaw customMode: true i przekaż swoje teksty w polu prompt. Suno zajmie się melodią, aranżacją, harmonią i wykonaniem wokalnym.

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

Dwie opcje:

  • Polling: GET /api/v1/generate/record-info?taskId=... co 5 sekund, aż state="success". Endpointy pollingowe są darmowe — nie liczą się do limitu zapytań ani kosztów.
  • Webhook: podaj callBackUrl. Gdy utwór będzie gotowy, wyślemy wynik JSON na Twój URL z podpisem HMAC-SHA256 w nagłówku X-AI-Signature.

5. Ostateczny payload

Po pomyślnym zakończeniu generacji otrzymasz dwa URL-e audio (Suno generuje warianty):

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

Oba pliki są w formacie MP3, 44.1 kHz, gotowe do odtwarzania. Będą dostępne pod URL-em bezterminowo, ale w produkcji powinieneś je pobrać i przechowywać na własnym CDN.

6. Wskazówki produkcyjne

  • Cache na swoim CDN — URL-e Suno są szybkie, ale kontrolujesz swoje SLA, gdy hostujesz je samodzielnie.
  • Przechowuj taskId w swojej bazie danych powiązanej z żądaniem użytkownika — ułatwia to ponowne próby i audyt.
  • Ustaw dzienny limit wydatków w ustawieniach dashboardu, jeśli udostępniasz tę funkcję użytkownikom końcowym.
  • Dla narracji w stylu podcastów użyj dedykowanego modelu TTS (szybszego i tańszego niż Suno).

To pełna pętla. Ten sam schemat działa dla Suno v3.5, v4, v4.5 Plus, MusicGen i Mureka — wystarczy zmienić pole model.