Suno API и MCP: как подключить генерацию музыки к своему проекту

Suno — семейство моделей генерации музыки. На NeuralSpace доступны модели: Suno V5.5, Suno V5, Suno V4.5+, Suno V4.5, Suno V4. Все они работают через единый публичный API, а для ИИ-агентов есть готовый MCP-сервер. Ключ выдаётся на странице API-ключей. Ниже — возможности модели, примеры запросов и способ настройки.

Что умеет Suno

Suno генерирует музыку по текстовому описанию, обычно два трека за генерацию. Доступны версии V5.5, V5, V4.5+, V4.5 и V4. Есть обычный режим по описанию и custom-режим с текстом песни, стилем и названием. Генерация асинхронная: статус опрашивается через GET /v1/music/generations/:id.

Эндпоинт API

Запрос отправляется на POST /v1/music/generations. Пример: {"model": "V5_5", "prompt": "спокойная инструментальная мелодия для фона", "instrumental": true}. Авторизация — по API-ключу в заголовке x-api-key. Доступные id моделей: V5_5, V5, V4_5PLUS, V4_5, V4.

MCP-инструменты

MCP-сервер NeuralSpace доступен по адресу POST /mcp (Streamable HTTP). Для работы с Suno агент использует инструменты: generate_music, check_music, list_models, get_balance. Это позволяет Claude Code, Cursor и другим MCP-клиентам пользоваться моделями сайта напрямую.

Как подключить

Зарегистрируйтесь на NeuralSpace, откройте API-ключей и создайте ключ формата nsk-…. Дальше передавайте его в заголовке запроса или в настройках MCP-клиента. Полная документация — на странице /v1/docs.

Частые вопросы

Сколько треков приходит за генерацию?

Обычно два трека за одну генерацию.

Можно ли задать текст песни?

Да, в custom-режиме передаются текст песни, стиль и название.

Какой формат у запроса?

POST /v1/music/generations с полями model и prompt.