Если в вашем продукте можно загружать песни, пользователи смогут опробовать разные аранжировки и манеры исполнения на одном аудио. Сервер сохраняет ID аудио, отправляет задачу для каждого варианта, проверяет её статус и передаёт готовые версии в проигрыватель.

Подключение

Поле

Описание

Эндпоинт

POST /v1/song/remix

Параметр модели

model=mureka-9.5

Источник аудио

Загрузите аудио с purpose=remix для получения upload_audio_id или используйте song_id песни, созданной в Mureka за последний месяц.

Длительность

10–480 s

Результатов на запрос

n по умолчанию 2, максимум 3

Цена

Новая версия: $0.5 за трек (цена V8 остаётся прежней — $0.2 за трек).

Документация

Документация API

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

Выбор модели: в запросе укажите mureka-9.5 в параметре model для Remix V9.5 или mureka-8 для V8.

Примеры использования

  • Приложения для каверов и ремиксов: создавайте полноценные аранжировки в разных стилях из записи вокала без сопровождения.
  • Короткие видео и контент-платформы: делайте рок-, электронные и джазовые версии фоновой музыки под настроение разных сцен.
  • Музыканты и инструменты продакшена: быстро превращайте спетое, сыгранное или напетое демо в полноценную аранжировку и пробуйте разные стили.
  • Музыка для игр и рекламы: варьируйте интенсивность одной темы от сцены к сцене, как в демо B.

Порядок вызовов API

Подготовьте исходное аудио

В примере используется песня с вокалом. Вызовите POST /v1/files/upload, задайте purpose=remix и сохраните полученный ID файла. V9.5 принимает MP3 и M4A длительностью от 10 до 480 секунд. Храните ключ API на сервере и используйте Bearer-аутентификацию.

curl --fail-with-body https://api.mureka.ai/v1/files/upload \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -F "purpose=remix" \
  -F "file=@./original.mp3"

Для песни, созданной через API генерации Mureka, можно указать подходящий song_id. Используйте upload_audio_id для загруженного файла или song_id для готовой песни. В каждом запросе выбирайте один вариант и сверяйте ограничения со справочником API.

Отправьте задачу для одного варианта ремикса

Передайте ID загрузки и prompt с описанием стиля в POST /v1/song/remix. В примере указана модель mureka-9.5 и запрошен рок-ремикс с вокалом. Подставьте полученный ID и текст, который будет исполнен.

curl --fail-with-body https://api.mureka.ai/v1/song/remix \
  -H "Authorization: Bearer ${MUREKA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "upload_audio_id": "<UPLOAD_AUDIO_ID>",
    "model": "mureka-9.5",
    "lyrics": "<LYRICS_FOR_THIS_VERSION>",
    "prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
    "n": 1
  }'

Чтобы запросить несколько результатов с одним prompt, используйте n. Для рока, EDM и версии с женским вокалом отправьте три запроса с одним ID загрузки и разными указаниями. Свяжите каждую задачу с ID оригинала, названием версии и ID задачи.

Проверяйте статус и показывайте результаты

Сохраните полученный ID задачи и вызывайте GET /v1/song/query/{task_id}. Во время генерации показывайте состояние ожидания и продолжайте проверку. После успеха используйте URL аудио для прослушивания. При сбое запишите ID и сведения об ошибке.

curl --fail-with-body \
  "https://api.mureka.ai/v1/song/query/${TASK_ID}" \
  -H "Authorization: Bearer ${MUREKA_API_KEY}"

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

Справочник API