Suno API a MCP: ako pridať generovanie hudby do vášho projektu

Suno je rodina modelov hudobnej generácie. NeuralSpace ponúka tieto modely: Suno V5.5, Suno V5, Suno V4.5+, Suno V4.5, Suno V4. Všetky bežia cez jediné verejné API a pre agentov AI je pripravený server MCP. Kľúč je vydaný naStránka kľúčov API. Nižšie sú uvedené možnosti modelu, príklady požiadaviek a kroky nastavenia.

Čo dokáže Suno

Suno generuje hudbu z textového popisu, zvyčajne dvoch skladieb na generáciu. Dostupné sú verzie V5.5, V5, V4.5+, V4.5 a V4. K dispozícii je normálny režim popisu a vlastný režim s textom, štýlom a názvom. Generovanie je asynchrónne: zisťovanie stavu cez GET /v1/music/generations/:id.

Koncový bod API

Pošlite žiadosť na POST /v1/music/generations. Príklad: {"model": "V5_5", "prompt": "a calm instrumental melody for background", "instrumental": true}. Autorizácia používa kľúč API v hlavičke x-api-key. Dostupné ID modelov: V5_5, V5, V4_5PLUS, V4_5, V4.

nástroje MCP

Server NeuralSpace MCP je dostupný na adrese POST /mcp (Streamable HTTP). Na prácu so Suno agent používa nástroje: generate_music, check_music, list_models, get_balance. To umožňuje Claude Code, Cursor a ďalším klientom MCP používať modely stránok priamo.

Ako sa pripojiť

Zaregistrujte sa na NeuralSpace, otvorteStránka kľúčov APIa vytvorte kľúč nsk-…. Potom ho odovzdajte v hlavičke požiadavky alebo v nastaveniach klienta MCP. Kompletná dokumentácia je nastránku /v1/docs.

FAQ

Koľko skladieb prichádza za generáciu?

Zvyčajne dve skladby za generáciu.

Môžem poskytnúť text piesne?

Áno, vo vlastnom režime odovzdávate texty, štýl a názov.

Aký formát má žiadosť?

POST /v1/music/generations s poľami modelu a výzvy.