Suno API i MCP: jak dodać generację muzyki do swojego projektu

Suno to rodzina modeli generowania muzyki. W ofercie NeuralSpace dostępne są następujące modele: Suno V5.5, Suno V5, Suno V4.5+, Suno V4.5, Suno V4. Wszystkie działają poprzez jeden publiczny interfejs API i istnieje gotowy serwer MCP dla agentów AI. Klucz wydawany jest naStrona kluczy API. Poniżej znajdują się możliwości modelu, przykłady żądań i kroki konfiguracji.

Co Suno może zrobić

Suno generuje muzykę na podstawie opisu tekstowego, zwykle dwóch utworów na pokolenie. Dostępne są wersje V5.5, V5, V4.5+, V4.5 i V4. Dostępny jest normalny tryb opisu i tryb niestandardowy z tekstami, stylem i tytułem. Generowanie jest asynchroniczne: odpytuj status za pomocą GET /v1/music/generacje/:id.

Punkt końcowy interfejsu API

Wyślij żądanie do POST /v1/music/generations. Przykład: {"model": "V5_5", "prompt": "a calm instrumental melody for background", "instrumental": true}. Autoryzacja wykorzystuje klucz API w nagłówku x-api-key. Dostępne identyfikatory modeli: V5_5, V5, V4_5PLUS, V4_5, V4.

Narzędzia MCP

Serwer NeuralSpace MCP jest dostępny pod adresem POST /mcp (Streamable HTTP). Do pracy z Suno agent wykorzystuje narzędzia: generate_music, check_music, list_models, get_balance. Dzięki temu Claude Code, Cursor i inni klienci MCP mogą bezpośrednio korzystać z modeli witryn.

Jak się połączyć

Zarejestruj się w NeuralSpace, otwórz plikStrona kluczy APIi utwórz klucz nsk-…. Następnie przekaż go w nagłówku żądania lub w ustawieniach klienta MCP. Pełna dokumentacja znajduje się na stroniestronę /v1/docs.

Często zadawane pytania

Ile utworów pojawia się na pokolenie?

Zwykle dwa utwory na pokolenie.

Czy mogę podać teksty piosenek?

Tak, w trybie niestandardowym przekazujesz tekst, styl i tytuł.

W jakim formacie jest żądanie?

POST /v1/music/generations z polami modelu i podpowiedzi.