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

ПеснеГен — российская web-платформа для генерации песен, разделения аудио на стемы, MIDI, караоке, мастеринга, эффектов и монтажа. Публичные страницы работают без VPN; платные действия требуют аккаунт, баланс и подтверждение.

## Машиночитаемые точки входа

- Краткий манифест: https://pesnegen.ru/llms.txt
- Полный манифест и схемы: https://pesnegen.ru/llms-full.txt
- MCP Streamable HTTP: https://pesnegen.ru/mcp
- MCP discovery: https://pesnegen.ru/.well-known/mcp.json
- OpenAPI 3.1: https://pesnegen.ru/openapi.json
- Публичный REST-каталог: https://pesnegen.ru/api/mcp/v1/tools
- Документация: https://pesnegen.ru/docs

## Правила действий

1. Каталог, тарифы и страницы действий пользователя можно читать без ключа.
2. Для execute-вызовов передавайте API-ключ как `Authorization: Bearer pg_live_...`.
3. Для любой платной операции сначала покажите цену и получите явное подтверждение пользователя.
4. Для платных вызовов используйте стабильный `idempotencyKey`, чтобы повтор запроса не вызвал двойное списание.
5. Файловые инструменты принимают multipart REST и возвращают Job. Статус succeeded означает результат обработчика, а не приём файла. Серверные пути и произвольные URL не принимаются.
6. Пока Job имеет queued или processing, кредит только зарезервирован. При failed, dead или cancelled резерв возвращается; при requires_action платный резерв освобождается сразу.
7. Не обещайте клонирование голоса: продукт поддерживает сценарии кавера и работы с загруженным вокалом, но не обучение персональной голосовой модели.

# Актуальные тарифы ПеснеГен

Источник истины: действующий каталог оплаты приложения. Валюта: RUB.

- После регистрации: 3 подарочные генерации.

## Пакеты токенов

- 1 токен: 69 RUB (разовая покупка)
- 5 токенов: 149 RUB (разовая покупка)
- 15 токенов: 349 RUB (разовая покупка)
- 50 токенов: 899 RUB (разовая покупка)

## Основные подписки

- Старт: 399 RUB / 30 дней; 30 токенов
- Кавер Pro: 890 RUB / 30 дней; 100 токенов
- Кавер Pro годовой: 6490 RUB / 365 дней; 1500 токенов

Токены из пакетов и подписок не являются безлимитом. Перед любой платной операцией агент обязан показать стоимость и получить явное подтверждение пользователя.

# Каталог инструментов ПеснеГен

## midiToSong — MIDI в песню

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/midi-v-pesnyu
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## mp3ToMidi — MP3 в MIDI

Создаёт Job распознавания нот и экспорта аудио в MIDI.

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/konverter-mp3-v-midi
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## midiToSheetMusic — MIDI в ноты PDF

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/noty-iz-audio
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## audioToSheetMusic — Песня в ноты

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/pesnyu-v-noty
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## convertAudio — Конвертер аудио

Создаёт Job конвертации MP3, WAV, FLAC, OGG, M4A и AAC.

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/konverter-audio-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## detectChords — Аккорды

Создаёт Job распознавания аккордов, BPM и тональности.

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/akkordy-pesni-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

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

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/pesnyu-v-noty
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

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

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/sdelat-minusovku-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## removeVocal — Убрать вокал

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/izvlech-vokal-iz-pesni
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## removeVocals — Минусовка

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/sdelat-minusovku-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## splitStems — Стемы

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/razdelit-pesnyu-na-stemy
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## makeKaraoke — Караоке

Создаёт Job караоке с текстом и таймингом.

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/karaoke-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## makeReels — Reels

Создаёт Job вертикального музыкального видео.

- Mode: execute
- Scope: tools:video:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/karaoke-online?mode=clip#editor
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## aiDirectorFromText — AI режиссёр

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

- Mode: execute
- Scope: tools:video:write
- Base API credit cost: 0
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/ai-rezhisser-klipa
- Input schema:

```json
{
  "type": "object",
  "properties": {
    "sourceText": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12000,
      "description": "Текст песни или описание ролика"
    },
    "mode": {
      "type": "string",
      "enum": [
        "clip",
        "film"
      ],
      "default": "clip"
    },
    "durationSec": {
      "type": "number",
      "minimum": 15,
      "maximum": 900,
      "default": 180
    },
    "createStoryboard": {
      "type": "boolean",
      "default": false
    },
    "fullStoryboard": {
      "type": "boolean",
      "default": false,
      "description": "Платное полное раскрытие storyboard"
    },
    "selectedIdeaId": {
      "type": "string"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Обязателен для платного полного storyboard"
    }
  },
  "required": [
    "sourceText"
  ],
  "additionalProperties": true
}
```

## applyEffects — Эффекты

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/effekty-onlajn
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## removeNoise — Убрать шум

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/ubrat-shum-iz-audio
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## masterTrack — Мастеринг

Создаёт Job мастеринга с жанровыми пресетами и A/B.

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/mastering-onlajn
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## openEditor — Редактор

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/audioredaktor-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## analyzeTrack — Анализ

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

- Mode: execute
- Scope: tools:audio:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/analiz-treka-online
- Input schema:

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

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

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

- Mode: execute
- Scope: generation:write
- Base API credit cost: 1
- Job result: poll /api/mcp/v1/jobs/{jobId} or use webhooks
- User action page: https://pesnegen.ru/generaciya-muzyki
- Input schema:

```json
{
  "type": "object",
  "properties": {
    "lyrics": {
      "type": "string",
      "minLength": 20,
      "maxLength": 20000,
      "description": "Готовый текст песни"
    },
    "prompt": {
      "type": "string",
      "maxLength": 1000,
      "description": "Жанр, вокал и аранжировка"
    },
    "trackName": {
      "type": "string",
      "maxLength": 120
    },
    "instrumental": {
      "type": "boolean",
      "default": false
    },
    "audioDuration": {
      "type": "number",
      "minimum": 20,
      "maximum": 300,
      "default": 120
    },
    "voiceId": {
      "type": "string",
      "maxLength": 80
    },
    "audioFormat": {
      "type": "string",
      "enum": [
        "wav",
        "mp3",
        "flac"
      ],
      "default": "wav"
    },
    "userConfirmedCreditSpend": {
      "type": "boolean",
      "const": true,
      "description": "Истина только после явного подтверждения списания API-кредитов"
    },
    "userConfirmedTokenSpend": {
      "type": "boolean",
      "const": true,
      "deprecated": true,
      "description": "Совместимый alias для старых клиентов"
    },
    "userConfirmationText": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Последнее подтверждающее сообщение пользователя"
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "Стабильный ключ повтора, предотвращающий двойное списание"
    }
  },
  "required": [
    "lyrics",
    "userConfirmedCreditSpend",
    "userConfirmationText",
    "idempotencyKey"
  ],
  "additionalProperties": true
}
```