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

# Voice Isolator

> Separate voice from background audio, music, and noise.

# Voice Isolator

`POST /api/v1/speech/isolator`

Separates vocal tracks from background audio, music, and ambient noise. Returns an isolated vocal track and optionally an isolated background track as separate files.

**Credit rate:** 750 credits per minute of audio

## Request

```bash theme={null}
curl -X POST https://www.voicelab360.com/api/v1/speech/isolator \
  -H "Authorization: Bearer vl360_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://your-bucket.com/mixed.mp3",
    "format": "wav",
    "return_background": true
  }'
```

## Parameters

| Parameter           | Type    | Required | Description                                           |
| ------------------- | ------- | -------- | ----------------------------------------------------- |
| `audio_url`         | string  | Yes      | Publicly accessible URL to mixed audio                |
| `format`            | string  | No       | Output format: `wav` (default), `mp3`, `flac`         |
| `return_background` | boolean | No       | Also return isolated background track. Default: false |

## Response

```json theme={null}
{
  "job_id": "job_iso_001",
  "status": "completed",
  "vocals_url": "https://cdn.voicelab360.com/iso/job_iso_001_vocals.wav",
  "background_url": "https://cdn.voicelab360.com/iso/job_iso_001_bg.wav",
  "duration_ms": 180000,
  "credits_used": 2250
}
```

## Notes

* `background_url` is only present in the response when `return_background` is set to true.
* Output URLs are signed and expire after 24 hours.