PopNowAPI
Получить API-ключ

Vocal Isolator API

от PopNow

Одна запись, отдельные дорожки голоса и фона

popnow/vocal-isolator-v1/audio-separation
  • Разделить голос и фон

О модели Vocal Isolator

Одна запись, отдельные дорожки голоса и фона.

Вызывайте его по имени модели popnow/vocal-isolator-v1/audio-separation через POST /jobs/createTask, от 0,0012 $.

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
audio_urlДаГолос или музыка, которые будут использованы.

Цены

Цены указаны в USD. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

ВариантUSD за секунду входного материала
Стандарт0,0012 $

Длительность входного материала округляется вверх до целых секунд, минимум — 1 секунд.

До запуска отправьте то же тело запроса в POST /jobs/quote, чтобы узнать ожидаемую и максимальную стоимость в USD. Расчёт не запускает задачу и не списывает деньги.

Быстрый старт API

Вызов API Vocal Isolator в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow-. Вызовы используют отдельный баланс в долларах США.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/vocal-isolator-v1/audio-separation и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/vocal-isolator-v1/audio-separation",
  "input": {
    "audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.

Вопросы об API Vocal Isolator

Сколько стоит API Vocal Isolator?

Vocal Isolator стоит 0,0012 $ за секунду. API использует отдельный баланс в долларах США. Кредиты сайта нельзя тратить в API или переводить на баланс API. Перевод с баланса API в кредиты сайта также недоступен. При принятии задачи мы резервируем максимальную сумму расчёта на балансе API. После завершения списываем плату за фактическое использование, не превышая резерв, и освобождаем остаток. Если задача завершается ошибкой, резерв освобождается.

Какое имя модели у Vocal Isolator в API?

Укажите popnow/vocal-isolator-v1/audio-separation — Разделить голос и фон в поле model запроса POST /jobs/createTask.

Это два альтернативных результата генерации?

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

Можно ли выбрать конкретного говорящего?

Нет. На вход подаётся сама запись; выбора говорящего и текстового промпта нет.

Будут ли дорожки идеально изолированы?

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

Можно попробовать Vocal Isolator без кода?

Запускайте Vocal Isolator в Playground с баланса API в USD без API-ключа. Каждый запуск сохраняется в истории разработчика с соответствующим кодом.

Ещё о Vocal Isolator