Agent API
ПеснеГен для AI-агентов
Публичный каталог из 20 инструментов, MCP Streamable HTTP 2025-11-25, OpenAPI и актуальные тарифы из одного источника данных.
MCP
/mcpJSON-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/toolscurl -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"}}}'Подключение клиента
Запросите доступ, согласуйте инструменты и объём пилота. После этого мы выдадим scoped API key: сохраните его при первом показе и передавайте в заголовке Authorization: Bearer …. Ключи имеют лимиты и могут быть отозваны.
{
"mcpServers": {
"pesnegen": {
"url": "https://pesnegen.ru/mcp",
"headers": {
"Authorization": "Bearer ${PESNEGEN_API_KEY}"
}
}
}
}API-кредиты
API использует отдельный баланс: пользовательские токены ПеснеГен через production-ключи не расходуются. Платный вызов резервирует кредиты, но считается успешным и попадает в расход только после результата обработчика. При ошибке, отмене или отсутствии исполняемого шага резерв возвращается.
| Пакет | Цена | API-кредиты | Срок |
|---|---|---|---|
| API Start | 4 990 ₽ | 1 000 | Не сгорают |
| API Growth | 14 900 ₽ | 4 000 | Не сгорают |
| API Scale | 39 900 ₽ | 12 000 | Не сгорают |
Инструменты
MIDI в песню
executemidiToSongСоздаёт Job для песни из MIDI; если нужен редактор, Job вернёт requires_action.
Открыть интерфейсMP3 в MIDI
executemp3ToMidiСоздаёт Job распознавания нот и экспорта аудио в MIDI.
Открыть интерфейсMIDI в ноты PDF
executemidiToSheetMusicСоздаёт Job подготовки MIDI к нотному PDF и продолжению в редакторе.
Открыть интерфейсПесня в ноты
executeaudioToSheetMusicСоздаёт Job преобразования песни в MIDI и нотную партитуру.
Открыть интерфейсКонвертер аудио
executeconvertAudioСоздаёт Job конвертации MP3, WAV, FLAC, OGG, M4A и AAC.
Открыть интерфейсАккорды
executedetectChordsСоздаёт Job распознавания аккордов, BPM и тональности.
Открыть интерфейсАудио в ноты (legacy)
executeextractNotesСоздаёт Job преобразования аудио в ноты, PDF и MIDI.
Открыть интерфейсМинусовка в кабинете
executemakeMinusovkaСоздаёт Job подготовки минусовки; успех возвращается только после обработки.
Открыть интерфейсУбрать вокал
executeremoveVocalСоздаёт Job удаления вокала из песни.
Открыть интерфейсМинусовка
executeremoveVocalsСоздаёт Job разделения песни на вокал и инструментал.
Открыть интерфейсСтемы
executesplitStemsСоздаёт Job разделения трека на вокал, барабаны, бас и инструменты.
Открыть интерфейсКараоке
executemakeKaraokeСоздаёт Job караоке с текстом и таймингом.
Открыть интерфейсReels
executemakeReelsСоздаёт Job вертикального музыкального видео.
Открыть интерфейсAI режиссёр
executeaiDirectorFromTextСоздаёт идеи клипа из текста; полный storyboard может потребовать API-кредиты.
Открыть интерфейсЭффекты
executeapplyEffectsСоздаёт Job шумоподавления, де-эссера, эффектов или обработки вокала.
Открыть интерфейсУбрать шум
executeremoveNoiseСоздаёт Job удаления шума через REST multipart; в MCP без файла возвращает requires_action.
Открыть интерфейсМастеринг
executemasterTrackСоздаёт Job мастеринга с жанровыми пресетами и A/B.
Открыть интерфейсРедактор
executeopenEditorСоздаёт Job редактора со статусом requires_action до действия пользователя.
Открыть интерфейсАнализ
executeanalyzeTrackСоздаёт Job анализа BPM, тональности, структуры и громкости.
Открыть интерфейсГенерация песни по тексту
executegenerateSongFromTextСтавит генерацию песни по тексту в очередь после явного подтверждения списания 1 API-кредита.
Открыть интерфейс