# Clear (`clear-1`): Speech enhancement

Background noise out, voice in front, at podcast loudness.

Clear takes a recording of someone talking and gives it back with the background noise removed and room echo reduced: fans, traffic, keyboards, hum, a busy kitchen. The result is 48 kHz audio, mastered to podcast loudness by default (or Spotify, YouTube, broadcast, your own target, or none), as MP3, WAV, FLAC or M4A.

`strength` blends in some of the original when full cleanup sounds too processed. In our tests on the VoiceBank+DEMAND test set it scored a PESQ of 3.16 (the noisy input scores 1.97).

- **Price:** $0.001 per minute. Billed per second of audio, rounded up, at least one second.
- **Languages:** Any (works on the sound of speech, not words)
- **Input:** An audio or video file: an https URL, a data URL, or a file in a multipart upload. MP3, WAV, M4A, OGG, FLAC, WebM, MP4 and more, up to 25 MB and 5 minutes.
- **Batch:** no, one input per call
- **Status:** live

## Request

```bash
curl https://labs.greatwork.company/v1/run \
  -H "Authorization: Bearer $GWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"clear-1","input":"https://labs.greatwork.company/examples/kitchen-voice-memo.mp3"}'
```

Upload a local file with multipart: `curl https://labs.greatwork.company/v1/run -H "Authorization: Bearer $GWL_API_KEY" -F model=clear-1 -F input=@file`

## Options

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `input` | audio (URL, data URL or upload) | yes | | An audio or video file: an https URL, a data URL, or a file in a multipart upload. MP3, WAV, M4A, OGG, FLAC, WebM, MP4 and more, up to 25 MB and 5 minutes. |
| `loudness` | string | no | `"podcast"` | `podcast` (-16 LUFS, the default), `apple_podcasts` (-16), `spotify` or `youtube` (-14), `broadcast` (-23), `none` (no mastering), or a LUFS target like `-18`. Quiet recordings get at most 12 dB of gain. |
| `strength` | number | no | `1` | How much cleanup, 0 to 1. Lower values blend in some of the original sound. |
| `format` | string (mp3 \| wav \| flac \| m4a) | no | `"mp3"` | Output format. MP3 is 192 kbps. |
| `sample_rate` | integer | no | `48000` | Output sample rate: 16000, 22050, 24000, 44100 or 48000. |

## Output

| Field | Type | Description |
|---|---|---|
| `audio` | string | The cleaned audio as a data URL (`data:audio/mpeg;base64,...`). |
| `format` | string | `mp3`, `wav`, `flac` or `m4a`. |
| `sample_rate` | integer | Output sample rate. |
| `duration` | number | Length in seconds. |
| `input_lufs` | number | Loudness of the cleaned speech before mastering (not with `loudness: none`). |
| `output_lufs` | number | Loudness after mastering. |
| `true_peak_db` | number | Peak level after mastering (at most -1.5 dB). |
| `input_snr_db` | number | How noisy the input was: estimated speech-to-noise ratio in dB (lower is noisier). |

The response envelope is always `{"id", "object": "run", "model", "created", "output", "usage": {"units", "unit", "cost_usd", "cost_micros"}, "latency_ms"}`.

## Examples (real outputs from our servers)

### Kitchen voice memo

```json
{
  "model": "clear-1",
  "input": "https://labs.greatwork.company/examples/kitchen-voice-memo.mp3"
}
```

```json
{
  "audio": "/examples/out/clear-1-0.mp3",
  "format": "mp3",
  "sample_rate": 48000,
  "duration": 7.03,
  "input_lufs": -26,
  "output_lufs": -16.2,
  "true_peak_db": -1.7,
  "input_snr_db": -6.4
}
```

763 ms, $0.000136.

### Noisy call

```json
{
  "model": "clear-1",
  "input": "https://labs.greatwork.company/examples/noisy-call.mp3"
}
```

```json
{
  "audio": "/examples/out/clear-1-1.mp3",
  "format": "mp3",
  "sample_rate": 48000,
  "duration": 5.93,
  "input_lufs": -29.1,
  "output_lufs": -17.1,
  "true_peak_db": -1.7,
  "input_snr_db": 1.1
}
```

715 ms, $0.000102.

### Echoey room

```json
{
  "model": "clear-1",
  "input": "https://labs.greatwork.company/examples/echoey-room.mp3"
}
```

```json
{
  "audio": "/examples/out/clear-1-2.mp3",
  "format": "mp3",
  "sample_rate": 48000,
  "duration": 5.71,
  "input_lufs": -21,
  "output_lufs": -16,
  "true_peak_db": -1.7,
  "input_snr_db": 0.8
}
```

612 ms, $0.000102.

### YouTube loudness

```json
{
  "model": "clear-1",
  "input": "https://labs.greatwork.company/examples/kitchen-voice-memo.mp3",
  "loudness": "youtube"
}
```

```json
{
  "audio": "/examples/out/clear-1-3.mp3",
  "format": "mp3",
  "sample_rate": 48000,
  "duration": 7.03,
  "input_lufs": -26,
  "output_lufs": -14.7,
  "true_peak_db": -1.7,
  "input_snr_db": -6.4
}
```

766 ms, $0.000136.

## Good for

- Podcast and interview tracks recorded at home
- Voice notes and voicemails before transcription
- Video voiceovers recorded on a phone
- Call recordings for review or training

## Limits and caveats

- Room echo is reduced, not removed: in a big or bare room some of the tail stays.
- Made for speech: music and singing in the background get treated as noise.
- When full cleanup sounds too processed, lower `strength` to keep some of the original.
- Up to 5 minutes per call: split longer recordings.
