Введение
Разделите существующую запись на голос и фоновое аудио одним запросом. Используйте обе выделенные дорожки для музыкальных репетиций, монтажа дикторского текста или нового микса.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Аудио |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
audio_url | Да | Сведённая запись для разделения, передаваемая в виде URL аудио. Элемент загрузки принимает MP3 или WAV. Не менее 1 символов |
Стоимость
$0.0012 / секунда
Плата взимается один раз за каждую секунду входного аудио с округлением вверх до целой секунды. Обе дорожки включены в одну и ту же плату за длительность. Этот эндпоинт принимает от 1 до 600 секунд.
Сценарии использования
Текст → audio-separation → Аудио
audio-separation
Аудио
Асинхронная задача
Руководство по промптам и практические советы
Введение
Vocal Isolator разделяет существующую аудиозапись на голосовую дорожку и фоновую дорожку. Передайте сведённую запись через audio_url; промпт и ранее созданная задача генерации музыки не нужны. Этот эндпоинт предназначен для работы с уже имеющимся звуком: например, записью репетиции песни, роликом с дикторским текстом или записью подкаста с фоновой музыкой.
Основные функции и особенности
Две выделенные дорожки из одной записи
Задача предназначена для возврата обеих частей одного источника: сначала голоса, затем оставшегося фона. В музыке фон — это инструментальное сопровождение. В записи речи он может включать музыку и звуки окружения. Это связанные дорожки, полученные в ходе одной обработки, а не два альтернативных результата генерации на выбор. После разделения могут остаться слышимые примеси звука или исчезнуть детали, которые перекрываются в обеих частях.
Длительность источника определяет объём для оплаты
Оплата рассчитывается по длительности входной записи, округлённой вверх до целых секунд. Получение двух дорожек не удваивает эту длительность. Этот эндпоинт принимает записи от 1 до 600 секунд. В нём нет настройки желаемой длительности результата, выбора говорящего или настройки выходного кодека. Сохраните исходный микс вместе с обоими результатами, чтобы сравнивать разделение, не теряя запись, с которой начали.
Варианты использования
Подготовка дорожки для музыкальной репетиции
Используйте фоновую дорожку как собственный аккомпанемент для репетиций, а голосовую сохраните для проверки фразировки. Прослушивайте не только громкие фрагменты, но и паузы: в сопровождении могут остаться реверберация и бэк-вокал. Сравнивайте при близких уровнях громкости прослушивания, прежде чем решить, подходит ли дорожка для репетиции.
Отделение дикторского текста от существующего микса
Если в ролике речь наложена на музыку, прослушайте голосовой результат перед добавлением в новый монтаж. Фоновая дорожка может быть полезна как ориентир при монтаже, но не гарантируется, что она содержит только музыку. При сравнении в редакторе выровняйте обе дорожки по одному и тому же началу источника.
Руководство по промптам и практические советы
Подготовка исходной записи
Промпта для настройки здесь нет. Загрузите самую чёткую из имеющихся версий сведённой записи, а не запись воспроизведения через динамики или дополнительно сжатую копию. Используйте MP3 или WAV через элемент загрузки. Этот эндпоинт обрабатывает весь переданный файл; если нужна лишь часть более длинной записи, сначала подготовьте отдельный исходный клип. Сохраните оригинал и дайте полученным дорожкам разные названия.
Проверка обеих дорожек перед использованием
Проверьте согласные в речи, протяжённые ноты, тишину между фразами, а также левый и правый каналы. Прислушайтесь, не проникают ли музыкальные звуки в голосовую дорожку и не остаётся ли голос в фоне. Не считайте, что повторное сложение дорожек точно восстанавливает оригинал. Измерьте их фактическую длительность перед монтажом длинных последовательностей и проверьте выравнивание в целевом редакторе. Формат результата, частота дискретизации и качество разделения всё ещё требуют проверки на вашем материале.
Быстрый старт 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": "spicyapi/vocal-isolator-v1/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.