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

# Audio Operations

> Audio processing — normalize, extract, mix, transcribe

## extract\_audio

Extract audio track from a video file.

```json theme={null}
{ "type": "audio_extract", "params": { "format": "mp3", "bitrate": "192k" } }
```

## normalize\_audio

Normalize audio loudness to broadcast standards (EBU R128).

```json theme={null}
{ "type": "audio_normalize", "params": { "target_lufs": -14 } }
```

## noise\_remove

Remove background noise from audio.

```json theme={null}
{ "type": "audio_noise-remove" }
```

## fade\_audio

Add fade in/out effects to audio.

```json theme={null}
{ "type": "audio_fade", "params": { "fade_in": 2.0, "fade_out": 3.0 } }
```

## mix\_audio

Mix multiple audio tracks together. Use an array of URLs as input.

```json theme={null}
{
  "input": ["https://example.com/voice.mp3", "https://example.com/music.mp3"],
  "operations": [{ "type": "audio_mix", "params": { "volumes": [1.0, 0.3] } }]
}
```

## pitch\_shift

Shift audio pitch up or down.

```json theme={null}
{ "type": "audio_pitch-shift", "params": { "semitones": 2 } }
```

## loudness\_analyze

Analyze audio loudness levels (LUFS, peak, dynamic range).

```json theme={null}
{ "type": "audio_loudness-analyze" }
```

Returns loudness metrics in the output without modifying the file.

## transcribe

Transcribe speech to text using OpenAI Whisper.

```json theme={null}
{ "type": "audio_transcribe", "params": { "language": "en" } }
```

| Param    | Type   | Description                                |
| -------- | ------ | ------------------------------------------ |
| language | string | Language code (en, es, fr, etc.) or "auto" |
| format   | string | Output format: text, srt, vtt, json        |

## waveform

Generate a visual waveform image from audio.

```json theme={null}
{ "type": "audio_waveform", "params": { "width": 1920, "height": 200, "color": "0x00ff00" } }
```