elevenlabs Audio Isolation API

openapi: 3.2.0
info:
  title: ElevenLabs Agents Audio Isolation API
  description: The ElevenLabs Audio Isolation API removes background noise from audio recordings, isolating vocal tracks from ambient sounds and interference. This is useful for cleaning up recordings, improving audio quality for podcasts and interviews, and preparing audio files for further processing such as voice cloning or transcription.
  version: '1.0'
  contact:
    name: ElevenLabs Support
    url: https://help.elevenlabs.io
  termsOfService: https://elevenlabs.io/terms-of-service
servers:
- url: https://api.elevenlabs.io
  description: Production Server
security:
- apiKeyAuth: []
tags:
- name: Audio Isolation
  description: Endpoints for isolating vocals from background noise in audio recordings.
paths:
  /v1/audio-isolation:
    post:
      operationId: isolateAudio
      summary: Isolate audio
      description: Removes background noise from an audio file, isolating the vocal content. Processes the uploaded audio and returns a cleaned version with background noise removed while preserving the vocal track.
      tags:
      - Audio Isolation
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AudioIsolationRequest'
      responses:
        '200':
          description: Audio isolation completed successfully
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
        '400':
          description: Bad request - invalid audio file
        '401':
          description: Unauthorized - invalid or missing API key
        '422':
          description: Unprocessable entity - audio file could not be processed
  /v1/audio-isolation/stream:
    post:
      operationId: isolateAudioStream
      summary: Isolate audio with streaming
      description: Removes background noise from an audio file and streams the cleaned audio back using chunked transfer encoding. Useful for processing larger files where streaming output is preferred.
      tags:
      - Audio Isolation
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/AudioIsolationRequest'
      responses:
        '200':
          description: Streaming isolated audio response
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
        '400':
          description: Bad request - invalid audio file
        '401':
          description: Unauthorized - invalid or missing API key
        '422':
          description: Unprocessable entity - audio file could not be processed
components:
  schemas:
    AudioIsolationRequest:
      type: object
      required:
      - audio
      properties:
        audio:
          type: string
          format: binary
          description: The audio file to process for vocal isolation. Supports common audio formats including MP3, WAV, FLAC, and OGG.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: xi-api-key
      description: ElevenLabs API key passed in the xi-api-key header for authentication.
externalDocs:
  description: ElevenLabs Audio Isolation API Documentation
  url: https://elevenlabs.io/docs/api-reference/audio-isolation/audio-isolation