Введение
Что делает этот эндпоинт
Он делит сведённую песню на пять стемов и возвращает каждый отдельным файлом WAV.
Важные входные данные
audio_url — единственный вход: песня MP3 или M4A длиной до 10 минут.
Что вы получите
Пять аудиоассетов, у каждого в поле stem указано: vocals, instrumental, drums, bass, other.
| Характеристика | Значение |
|---|---|
| Ввод | Аудио |
| Вывод | Аудио |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
audio_url | Да | Песня для разделения: загруженный MP3 или прямая ссылка на файл MP3 или M4A, не длиннее 10 минут. WAV, FLAC и другие форматы отклоняются при отправке и не оплачиваются. Не менее 1 символов |
Стоимость
$0.108 / песня
Фиксированная плата за песню независимо от длины, до 10 минут. Все пять стемов включены. Неудачные запросы не оплачиваются.
Сценарии использования
Аудио → Разделение аудио → Аудио
Разделение аудио
Аудио
Асинхронная задача
Руководство по промптам и практические советы
Введение
Mureka Stem Separation — разделитель на стемы от Mureka, компании, которая делает музыку с помощью ИИ. Отдайте ему готовую сведённую песню, и он вернёт её части: ведущий и бэк-вокал на одной дорожке, весь аккомпанемент на другой и этот аккомпанемент, разложенный ещё раз на ударные, бас и всё остальное.
Запрос
{
"audio_url": "https://example.com/song.mp3"
}
Песня должна быть файлом MP3 или M4A. WAV, FLAC и другие форматы отклоняются при отправке.
Что возвращается
Задача возвращает пять аудиоассетов, по одному на стем, у каждого есть поле stem:
| stem | содержимое |
|---|---|
vocals | ведущий и бэк-вокал |
instrumental | всё, кроме голосов |
drums | ударные из инструментала |
bass | басовая партия из инструментала |
other | остальной инструментал: гитары, клавишные, пэды, эффекты |
Каждый стем — стерео WAV 16 бит, 44,1 кГц, ровно той же длины, что и песня, поэтому все пять совпадают с первого сэмпла в любом редакторе.
Что мы увидели в тестах
Мы разделили 60-секундный дуэт в стиле босса-нова и 30-секундный фрагмент той же песни. Оба запроса завершились примерно за десять секунд или быстрее. Ударные, бас и прочее в сумме совпали с инструменталом сэмпл в сэмпл. В чисто инструментальных местах вокальный стем оставался почти беззвучным, примерно на 55 дБ тише поющихся фрагментов, то есть звук группы туда почти не попадал. 60-секундный WAV весил около 10,6 МБ.
Ход задачи
Вызов асинхронный: создайте задачу, опрашивайте её до завершения, затем скачайте каждый стем из хранилища SpicyAPI. Неудачные запросы не оплачиваются.
Советы
- Начинайте с лучшей копии, какая у вас есть: артефакты сильно сжатого MP3 перейдут во все стемы.
- Для караоке-минусовки берите
instrumental; чтобы пересобрать сведение с другим звуком ударных, беритеvocals,bassиother. - Стемы не сжаты, поэтому трёхминутная песня даёт в сумме около 160 МБ аудио.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/stem-separation/audio-separation",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.

