> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Audio Separation Result

> Retrieves detail information about a specific audio separation run using the provided `run_id`.

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

```json theme={null}
{
  "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.


## OpenAPI

````yaml get /audio-separation-result/{run_id}
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /audio-separation-result/{run_id}:
    get:
      tags:
        - APIs
        - Audio-Separation
      summary: Get Audio Separation Run Info
      operationId: get_audio_separation_run_info_audio_separation_result__run_id__get
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/RunIDParam'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudioSeparationRunInfoResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    RunIDParam:
      type: integer
      title: Run ID
      description: >-
        The unique identifier for the run, which was generated during the
        creation process and returned upon task completion.
    AudioSeparationRunInfoResponse:
      properties:
        foreground_audio_url:
          type: string
          title: Audio Separation Foreground Audio URL
          description: >-
            The URL pointing to the generated audio file for the detected
            foreground audio.
        background_audio_url:
          type: string
          title: Audio Separation Background Audio URL
          description: >-
            The URL pointing to the generated audio file for the detected
            background audio.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        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.

````