GET
/
audio-separation-result
/
{run_id}
curl --request GET \
  --url https://client.camb.ai/apis/audio-separation-result/{run_id} \
  --header 'x-api-key: <api-key>'
{
  "foreground_audio_url": "<string>",
  "background_audio_url": "<string>"
}

​
Accessing Your Separated Audio Components

Once your audio separation task completes successfully, this endpoint provides immediate access to the isolated audio components. The system divides your original audio into two distinct tracks: a foreground track containing primary audio elements (typically speech, vocals or main instruments) and a background track with remaining audio elements. These isolated components enable creative flexibility for remixing, enhancing specific audio elements, or removing unwanted sounds from your original recording.

​
Understanding Audio Separation Results

  • Foreground Audio: Contains dominant audio elements, typically vocals, speech, or lead instruments that represent the primary focus of the recording
  • Background Audio: Contains ambient sounds, musical accompaniment, or secondary audio elements that provide context or support to the foreground elements

Audio separation technology analyzes the spectral and temporal characteristics of your audio file to identify and isolate different sound components. The separation process creates two complementary audio files that, when combined, reconstruct your original recording:

  • Foreground Audio: Contains dominant audio elements, typically vocals, speech, or lead instruments that represent the primary focus of the recording
  • Background Audio: Contains ambient sounds, musical accompaniment, or secondary audio elements that provide context or support to the foreground elements

This dual-track approach gives you unprecedented control over your audio content for professional editing, creative remixing, or accessibility enhancements.

​
Retrieving Separated Audio Files

After your separation task completes, you’ll receive a run_id that serves as your access key to the processed audio files. Simply make a GET request to this endpoint using that identifier to retrieve download URLs for both audio components.

​
Response Structure

A successful response returns direct download URLs for both the foreground and background audio files:

{
  "foreground_audio_url": "<URL_TO_THE_DETECTED_FOREGROUND_AUDIO>",
  "background_audio_url": "<URL_TO_THE_DETECTED_BACKGROUND_AUDIO>"
}

Each URL points to a standard audio file that can be downloaded directly or streamed into your application.

Authorizations

​
x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

​
run_id
integer
required

The unique identifier for the run, which was generated during the creation process and returned upon task completion.

Response

200
application/json

Successful Response

The response is of type object.