Vocal Isolator API

About Vocal Isolator

One recording, separate voice and background tracks.

Call it with the model name popnow/vocal-isolator-v1/audio-separation on POST /jobs/createTask, from $0.0012.

Introduction

Vocal Isolator separates an existing audio recording into a vocal track and a background track. Send the mixed recording through audio_url; no prompt or previously generated music task is needed. This endpoint is for working with sound you already have, such as a song rehearsal, a narrated clip or a podcast recording with music underneath.

Key features

Two stems from one recording

The task is intended to return both parts of the same source: vocals first and the remaining background second. In music, the background is the instrumental accompaniment. In a spoken recording, it can include music and environmental sound. These are related stems from one processing job, rather than two alternative generations to choose between. Separation can leave audible leakage or remove details that overlap between the two parts.

Request parameters

Pricing

Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

Input duration is rounded up to whole seconds, with a 1-second minimum.

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

Prepare a music practice track

Use the background stem to rehearse against your own backing track, and keep the vocal stem for checking phrasing. Listen through pauses as well as loud passages: reverberation and backing vocals can remain in the accompaniment. Compare at similar listening levels before deciding whether a stem is suitable for the rehearsal.

Separate narration from an existing mix

For a clip with speech over music, audition the vocal result before placing it into a new edit. The background stem can be useful as an editing reference, but it is not guaranteed to contain only music. Keep both stems aligned to the same source start when comparing them in your editor.

Prompt guide & pro tips

Prepare the source recording

There is no prompt to tune. Upload the clearest version of the mixed recording you have, rather than a recording of loudspeaker playback or an extra compressed copy. Use MP3 or WAV through the upload control. This endpoint handles the complete supplied file; prepare a separate source clip first if only part of a longer recording is needed. Preserve the original and give the derived stems distinct names.

Review both tracks before using them

Check speech consonants, sustained notes, silence between phrases and the left and right channels. Listen for musical sound leaking into the vocals and voice remaining in the background. Do not assume that adding the stems back together reconstructs the original exactly. Measure their actual lengths before editing long sequences, and verify alignment in the target editor. Output format, sample rate and separation quality still require validation with your material.

API quick start

Call the Vocal Isolator API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
2. Send the request. POST /jobs/createTask with model popnow/vocal-isolator-v1/audio-separation and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 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"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Vocal Isolator API questions

More about Vocal Isolator

Try it

Try in PlaygroundVideo Editor · Separate voice and background

Docs

Vocal Isolator model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesWebhooks: get Vocal Isolator results without polling