Agent API

ПеснеГен для AI-агентов

Публичный каталог из 26 инструментов, MCP Streamable HTTP 2025-11-25, OpenAPI и актуальные тарифы из одного источника данных.

MCP

/mcp

JSON-RPC: initialize, tools/list, tools/call и resources

REST

/api/mcp/v1/tools

Публичный каталог; execute-вызовы по Bearer API key

OpenAPI

/openapi.json

Схемы JSON и multipart для файловых Jobs

Быстрая проверка

Discovery не требует ключа. Выполнение от аккаунта требует scoped API key.

curl -sS https://pesnegen.ru/api/mcp/v1/tools
curl -sS https://pesnegen.ru/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}'

Подключение клиента

Войдите в API-кабинет и выпустите scoped API key без заявки. Сохраните секрет при первом показе и передавайте в заголовке Authorization: Bearer …. Ключи имеют лимиты и могут быть отозваны.

{
  "mcpServers": {
    "pesnegen": {
      "url": "https://pesnegen.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${PESNEGEN_API_KEY}"
      }
    }
  }
}

API-токены

API использует отдельный баланс: пользовательские токены ПеснеГен через production-ключи не расходуются. Платный вызов резервирует API-токены, но считается успешным и попадает в расход только после результата обработчика. При ошибке, отмене или отсутствии исполняемого шага резерв возвращается.

ПакетЦенаAPI-токеныСрок
API Start2 490 ₽200Не сгорают
API Growth12 490 ₽1 000Не сгорают
API Scale49 900 ₽4 000Не сгорают

Analysis API Pro — 9 900 ₽ / 30 дней

До 100 анализов в сутки и 2 000 в месяц без списания токенов. Один параллельный запрос, файл до 10 минут, без гарантированного SLA. После fair use стоимость рассчитывается посекундно: 1 API-токен за 5 минут исходного аудио.

Текущая инфраструктура

Публичный сайт, API, очередь, база данных и производственные аудиоворкеры работают на одном сервере 141.105.64.68. Публичный контракт не предполагает выбора сервера или переключения между gen и main; маршрутизацию задач полностью выполняет ПеснеГен.

Инструменты

MIDI в песню

execute
midiToSong

Создаёт Job для песни из MIDI; если нужен редактор, Job вернёт requires_action.

Открыть интерфейс

MIDI в ноты PDF

execute
midiToSheetMusic

Создаёт Job подготовки MIDI к нотному PDF и продолжению в редакторе.

Открыть интерфейс

Песня в ноты

execute
audioToSheetMusic

Создаёт Job преобразования песни в MIDI и нотную партитуру.

Открыть интерфейс

Аудио в ноты (legacy)

execute
extractNotes

Создаёт Job преобразования аудио в ноты, PDF и MIDI.

Открыть интерфейс

Минусовка в кабинете

execute
makeMinusovka

Создаёт Job подготовки минусовки; успех возвращается только после обработки.

Открыть интерфейс

Минусовка

execute
removeVocals

Создаёт Job разделения песни на вокал и инструментал.

Открыть интерфейс

Стемы

execute
splitStems

Создаёт Job разделения трека на вокал, барабаны, бас и инструменты.

Открыть интерфейс

AI режиссёр

execute
aiDirectorFromText

Создаёт идеи клипа из текста; полный storyboard может потребовать API-токены.

Открыть интерфейс

Эффекты

execute
applyEffects

Создаёт Job шумоподавления, де-эссера, эффектов или обработки вокала.

Открыть интерфейс

Убрать шум

execute
removeNoise

Создаёт Job удаления шума через REST multipart; в MCP без файла возвращает requires_action.

Открыть интерфейс

Обрезать аудио

execute
trimAudio

Обрезает загруженное аудио по startTime/endTime; без границ возвращает безопасный переход в интерфейс обрезки.

Открыть интерфейс

Наложить аудио на аудио

handoff
overlayAudio

Бесплатно передаёт основной аудиофайл в ручной микс; второй трек, позиция, громкость и панорама настраиваются в интерфейсе. Экспорт результата в интерфейсе стоит 69 ₽ или 1 пользовательский токен, в Pro включён.

Открыть интерфейс

Редактор

execute
openEditor

Создаёт Job редактора со статусом requires_action до действия пользователя.

Открыть интерфейс

Анализ

execute
analyzeTrack

Создаёт Job анализа BPM, тональности, структуры и громкости.

Открыть интерфейс

Транскрибация аудио

execute
transcribeAudio

Проверяет аудио без списания, возвращает серверный quote, а после явного подтверждения создаёт Job и выдаёт TXT, SRT, VTT и JSON.

Открыть интерфейс

Публичный чарт и библиотека треков

execute
getPublicChart

Возвращает публичные треки ПеснеГен: в тренде, новые релизы, жанры и авторов. Read-only, бесплатно; звёздные оценки поднимают треки в выдаче.

Открыть интерфейс

Поиск музыкальных промптов

execute
searchPrompts

Ищет 1–5 проверенных карточек в публичном каталоге. Read-only, бесплатно, не запускает генерацию и ничего не списывает.

Открыть интерфейс

Карточка музыкального промпта

execute
getPrompt

Возвращает одну карточку публичного каталога по slug. Read-only, бесплатно; useUrl только заполняет форму генерации.

Открыть интерфейс

Генерация песни по тексту

execute
generateSongFromText

Ставит генерацию песни по тексту в очередь после явного подтверждения списания API-токенов.

Открыть интерфейс