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

:::callout{intent="tip"}
Use the [ElevenLabs voice-isolator skill](https://github.com/elevenlabs/skills/tree/main/voice-isolator) to remove background noise from audio files from your AI coding assistant:

```bash
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](https://elevenlabs.io/app/settings/api-keys), which you’ll use to securely [access the API](/guides/api-reference-authentication).

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`**

```js title=".env"
ELEVENLABS_API_KEY=<your_api_key_here>
```

#### Install the SDK

#### SDK

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

```python
pip install elevenlabs
pip install python-dotenv
```

```typescript
npm install @elevenlabs/elevenlabs-js
npm install dotenv
```

#### CLI

Install the ElevenLabs CLI. Homebrew (macOS) and Scoop (Windows) are recommended.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

:::callout{intent="tip"}
Working with an AI coding assistant? Run `elevenlabs generate-skills` in your project to write a
`SKILL.md` for every command group into `skills/`, so your assistant knows the CLI's full surface
without you pasting docs. Use `--output-dir` to put them elsewhere. This reads the CLI's own
embedded API definition, so it needs no API key and works offline — and it stays in step with
whichever CLI version you have installed.
:::

Then authenticate — this opens your browser to authorize the CLI:

```bash
elevenlabs auth login
```

:::callout{intent="note"}
To play the audio through your speakers, you may be prompted to install [MPV](https://mpv.io/)
and/or [ffmpeg](https://ffmpeg.org/).
:::

#### Make the API request

#### SDK

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

```python maxLines=0
# example.py
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import requests
from io import BytesIO

load_dotenv()

elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)

audio_url = "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3"
response = requests.get(audio_url)
audio_data = BytesIO(response.content)

audio_stream = elevenlabs.audio_isolation.convert(audio=audio_data)

play(audio_stream)
```

```typescript maxLines=0
// example.mts
import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();

const audioUrl =
  "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3";
const response = await fetch(audioUrl);
const audioBlob = new Blob([await response.arrayBuffer()], {
  type: "audio/mp3",
});

const audioStream = await elevenlabs.audioIsolation.convert({
  audio: audioBlob,
});

await play(audioStream);
```

Then run it:

```python
python example.py
```

```typescript
npx tsx example.mts
```

You should hear the isolated voice playing through your speakers.

#### CLI

Download the sample audio, then isolate the voice:

```bash
curl -O https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/voice_with_background.mp3

elevenlabs audio-isolation convert \
  --audio voice_with_background.mp3 \
  --output isolated.mp3
```

Open `isolated.mp3` to hear the isolated voice.

## Next steps

#### [Voice Changer](/guides/elevenapi-guides-cookbooks-voice-changer)

Transform the voice in an audio file to a different voice

#### [Speech to Text](/guides/elevenapi-guides-cookbooks-speech-to-text)

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

#### [API reference](/guides/changelog-api-reference-text-to-dialogue-convert)

Explore all Voice Isolator parameters and response formats

## Related pages

- [Administration](./administration-index.md)
- [API reference](./api-reference-index.md)
- [Changelog](./changelog-index.md)
- [ElevenAgents](./elevenagents-index.md)
- [ElevenAPI](./elevenapi-index.md)
- [ElevenCreative](./elevencreative-index.md)
- [ElevenLabs Documentation Docs](../index.md)
- [General Troubleshooting FAQ](./troubleshooting-index.md)
- [General Website FAQ](./website-index.md)
- [Help Center](./help-center-2-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.