POST/v1/music/generations
Создание музыки
Запрос сразу возвращает ID заказа, а генерация продолжается асинхронно. Стоимость списывается с баланса аккаунта один раз; при технической ошибке генерации она возвращается автоматически.
Свои слова и стиль
curl -X POST 'https://api.моипесни.рф/v1/music/generations' \
-H 'Authorization: Bearer msp_live_...' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-order-001' \
-d '{
"customMode": true,
"instrumental": false,
"model": "pro-6",
"title": "Летний свет",
"style": "indie pop, warm vocal, acoustic guitar",
"prompt": "[Verse]\nГород просыпается...",
"negativeTags": "heavy metal, aggressive drums",
"vocalGender": "f",
"callBackUrl": "https://example.com/webhooks/moi-pesni"
}'
Генерация по описанию
{
"customMode": false,
"instrumental": false,
"prompt": "Светлая поп-песня о летнем путешествии"
}
| Поле | Тип | Обязательность | Описание |
| customMode | boolean | Нет | По умолчанию false: prompt описывает идею песни, а текст при необходимости создаётся автоматически. При true вы передаёте точный текст песни, стиль и название. |
| instrumental | boolean | Нет | По умолчанию false. Значение true создаёт трек без вокала. В custom mode тогда достаточно передать style и title, без prompt. |
| model | string | Нет | Версия модели определяет характер генерации. Если поле не передано, используется pro-6. Доступны pro-6, pro-6-wild и pro-6-mini; подробное сравнение приведено ниже. |
| prompt | string | Условно | При customMode=false это идея песни до 500 символов: жанр, настроение, сюжет, инструменты, темп и тип вокала. При customMode=true это точный текст до 5000 символов, который будет использован как слова песни; можно применять разметку [Verse], [Chorus], [Bridge]. |
| style | string | customMode=true | Музыкальное задание до 1000 символов. Через запятую укажите жанр и поджанр, настроение, темп, инструменты, тип вокала и характер продакшена. Например: indie pop, dreamy, 105 bpm, warm female vocal, acoustic guitar. |
| title | string | customMode=true | Название трека. До 80 символов. |
| negativeTags | string | Нет | Стили, инструменты и черты, которых желательно избежать. Перечисляйте через запятую: heavy metal, distorted guitar, aggressive drums. До 1000 символов; работает только в custom mode и является пожеланием, а не строгим фильтром. |
| vocalGender | string | Нет | Предпочтительный тип вокала: m/male или f/female. Используется только в custom mode. Это направление для модели, а не гарантия конкретного тембра. |
| callBackUrl | HTTPS URL | Нет | Адрес, на который после завершения или ошибки заказа придёт POST с результатом. Максимум 2048 символов; разрешён только HTTPS. Приватные сети, логин и пароль в URL, а также фрагменты заблокированы. |
| styleWeight | number | Нет | Насколько сильно результат должен следовать полю style. Диапазон от 0 до 1: меньше — больше свободы модели, больше — сильнее влияние заданного стиля. |
| weirdnessConstraint | number | Нет | Степень творческого отклонения и необычности. Диапазон от 0 до 1: низкие значения дают более предсказуемый результат, высокие — более экспериментальный. |
| audioWeight | number | Нет | Сила влияния исходного аудио, когда операция работает с загруженным треком. Диапазон от 0 до 1. Для обычной генерации по тексту без исходного аудио параметр обычно не нужен. |
Заказ принят: HTTP 202 Accepted
После отправки POST /v1/music/generations API не ждёт окончания генерации. Для нового заказа он сразу возвращает HTTP-статус 202 Accepted: запрос принят и поставлен в обработку, но треки ещё не готовы. Сохраните data.id из ответа — по нему можно проверять состояние заказа через GET /v1/orders/{id}. Если указан callBackUrl, итоговый результат также придёт на этот адрес.
{
"data": {
"id": "019c...",
"type": "music_generation",
"status": "pending",
"price": "25.00",
"currency": "RUB",
"result": null,
"error": null,
"callback": {"requested": true, "status": "pending", "attempts": 0}
},
"meta": {"idempotent_replay": false}
}
При повторе того же запроса с тем же Idempotency-Key новый заказ не создаётся: API возвращает существующий заказ с HTTP 200 OK и meta.idempotent_replay=true.