API музыкального ИИ

Техническая документация для клиентов, купивших доступ к API

AuraAi API позволяет встроить генерацию музыки в собственное приложение, сайт, бота или игру: текст песни, полноценный трек с вокалом, видео к треку, ИИ-кавер, разделение дорожек и звуковые эффекты — всё через единый REST API с ответами в формате JSON.

1. Базовый URL и авторизация

Все запросы отправляются на:

https://aurasoundai.ru/api/v1

В каждый запрос нужно добавить заголовок с ключом доступа, который выдаётся после покупки подписки на API:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

2. Генерация текста песни

POST/lyrics/generate

Пример запроса:

{
  "occasion": "День рождения мамы",
  "genre": "Поп",
  "mood": "Тёплое",
  "inspiration": "Мама поддерживает всю семью",
  "lang": "ru"
}

Пример ответа — возвращаются два варианта текста на выбор:

{
  "variants": [
    "[Куплет 1]\n...",
    "[Куплет 1]\n..."
  ]
}

3. Генерация песни

POST/songs/generate

Ответ содержит идентификатор задачи для дальнейшего опроса статуса:

{ "task_id": "b6e2f1a4-..." }

4. Проверка статуса задачи

GET/tasks/{task_id}

Единый эндпоинт для отслеживания результата песни, видео, кавера, разделения дорожек и звукового эффекта. Возможные значения status: starting, generating, waiting_audio, done, error.

{
  "status": "done",
  "title": "С днём рождения!",
  "audio_url": "https://.../track.mp3",
  "image_url": "https://.../cover.jpeg"
}

Рекомендуемый интервал опроса — раз в 3–5 секунд, среднее время полной генерации песни — 1–2 минуты.

5. Видео к треку

POST/videos/generate

{ "song_task_id": "b6e2f1a4-..." }

Возвращает новый task_id; результат (поле video_url) забирается через тот же эндпоинт проверки статуса.

6. ИИ-кавер

POST/covers/generate

{
  "upload_url": "https://storage.example.com/audio.mp3",
  "style": "акустика, лоу-фай",
  "title": "Кавер",
  "instrumental": false
}

upload_url должен быть публично доступен — API скачивает файл по этому адресу для обработки.

7. Разделение дорожки на вокал и инструменты

POST/split/generate

{
  "upload_url": "https://storage.example.com/audio.mp3",
  "mode": "separate_vocal"
}

Значения mode: separate_vocal — вокал и минусовка (2 дорожки), split_stem — до 12 отдельных инструментов. Результат приходит в поле stems объектом вида {"vocal": "url", "instrumental": "url", ...}.

8. Звуковые эффекты

POST/sounds/generate

{
  "prompt": "мягкий шум дождя с дальним громом",
  "loop": false,
  "tempo": 120
}

9. Boost описания стиля

POST/style/boost

Синхронный запрос — результат приходит сразу, без опроса статуса.

// Запрос
{ "content": "поп, загадочная атмосфера" }

// Ответ
{ "result": "Мелодичная поп-композиция с загадочной, туманной атмосферой..." }

10. Коды ошибок

11. Модель оплаты и лимиты

Доступ к API предоставляется по предоплаченным пакетам запросов — аналогично тарифам на сайте, но по оптовым ценам при больших объёмах. Каждый вызов генерации списывает один кредит из подключённого пакета в зависимости от типа операции. Индивидуальные условия и лимит частоты запросов согласовываются при подключении под вашу нагрузку.

12. Допустимое использование

API можно использовать для встраивания генерации музыки в собственные продукты и их дальнейшей монетизации, включая предоставление доступа конечным пользователям в составе своего продукта. Запрещено: передавать выданный ключ доступа третьим лицам без согласования, использовать API для контента, нарушающего законодательство или права третьих лиц, а также для создания дипфейков голоса реальных людей без их согласия.

13. Как получить ключ

Публичный самостоятельный выпуск ключей пока не запущен. Чтобы подключить API к своему проекту, напишите нам через бот в Telegram/MAX «Аура ИИ» — расскажите о задаче и ожидаемой нагрузке, мы согласуем условия и пришлём тестовый ключ.

14. Контакты

По техническим вопросам и вопросам подключения обращайтесь через бот в Telegram/MAX «Аура ИИ» или на почту auraai@mail.ru.