Voice Isolator quickstart | ElevenLabs Documentation

This guide will show you how to remove background noise from an audio file using the Voice Isolator API.

Use the ElevenLabs voice-isolator skill to remove background noise from audio files from your AI coding assistant:

$ npx skills add elevenlabs/skills --skill voice-isolator

Using the Voice Isolator API

Create an API key

Create an API key in the dashboard here, which you’ll use to securely access the API.

Store the key as a managed secret and pass it to the SDKs either as a environment variable via an .env file, or directly in your app’s configuration depending on your preference.

.env

1 ELEVENLABS_API_KEY=<your_api_key_here>

Install the SDK

We’ll also use the dotenv library to load our API key from an environment variable.

1 pip install elevenlabs
2 pip install python-dotenv

To play the audio through your speakers, you may be prompted to install MPV and/or ffmpeg.

Make the API request

Create a new file named example.py or example.mts, depending on your language of choice and add the following code:

1 # example.py
2 import os
3 from dotenv import load_dotenv
4 from elevenlabs.client import ElevenLabs
5 from elevenlabs.play import play
6 import requests
7 from io import BytesIO
8 
9 load_dotenv()
10 
11 elevenlabs = ElevenLabs(
12   api_key=os.getenv("ELEVENLABS_API_KEY"),
13 )
14 
15 audio_url = "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3"
16 response = requests.get(audio_url)
17 audio_data = BytesIO(response.content)
18 
19 audio_stream = elevenlabs.audio_isolation.convert(audio=audio_data)
20 
21 play(audio_stream)

Execute the code

1 python example.py

You should hear the isolated voice playing through your speakers.

Next steps

Voice Changer

Transform the voice in an audio file to a different voice

Speech to Text

Transcribe the isolated voice to text with the Speech to Text API

API reference

Explore all Voice Isolator parameters and response formats