Если в вашем продукте можно загружать песни, пользователи смогут опробовать разные аранжировки и манеры исполнения на одном аудио. Сервер сохраняет ID аудио, отправляет задачу для каждого варианта, проверяет её статус и передаёт готовые версии в проигрыватель.
Подключение
Поле | Описание |
|---|---|
Эндпоинт |
|
Параметр модели |
|
Источник аудио | Загрузите аудио с purpose=remix для получения upload_audio_id или используйте song_id песни, созданной в Mureka за последний месяц. |
Длительность | 10–480 s |
Результатов на запрос | n по умолчанию 2, максимум 3 |
Цена | Новая версия: $0.5 за трек (цена V8 остаётся прежней — $0.2 за трек). |
Документация |
Результат представляет собой новую интерпретацию песни и не сохраняет тембр исходного исполнителя. Пока нельзя указать тембр конкретного исполнителя или загрузить дополнительное аудио как образец стиля.
Выбор модели: в запросе укажите 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