Voice Isolator quickstart

Learn how to remove background noise from an audio file using the Voice Isolator API.

Voice Isolator quickstart

Learn how to remove background noise from an audio file using the Voice Isolator API.

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

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)