Configuration Reference

Every parameter maps directly to client.process().

Cleanvoice resamples all audio to 44.1 kHz or 48 kHz before processing. Your original file is not modified — the cleaned output uses the resampled rate.

Option reference

Audio cleaning

Option	Type	Default	Description
`fillers`	`bool`	`False`	Remove "um", "uh", "like", and similar filler words
`long_silences`	`bool`	`False`	Trim long pauses and gaps between sentences
`mouth_sounds`	`bool`	`False`	Remove clicks, lip smacks, and tongue sounds
`breath`	`bool \| str`	`False`	Remove audible breathing between sentences
`stutters`	`bool`	`False`	Remove repeated word fragments ("I— I— I think")
`hesitations`	`bool`	`False`	Remove short hesitation sounds that aren't full filler words
`muted`	`bool`	`False`	Silence edits instead of cutting — preserves original timing

Filler and hesitation detection is language-aware. English, German, and Romanian have the most accurate models. See supported languages.

breath options:

Value	Behavior
`True`	Recommended for most audio. Best default for challenging recordings.
`"legacy"`	Conservative removal. Safer choice for already-clean recordings.
`"natural"`	Lighter touch — preserves more of the original breathing feel.
`False`	Disabled (default).

Audio enhancement

Option	Type	Default	Description
`remove_noise`	`bool`	`True`	Reduce hiss, hum, fan noise, and background sounds. On by default; pass `False` to disable it.
`studio_sound`	`bool \| str`	`False`	Aggressive enhancement for studio-quality output.
`normalize`	`bool`	`False`	Balance volume levels throughout the file
`keep_music`	`bool`	`False`	Preserve music sections during noise reduction
`autoeq`	`bool`	`False`	Legacy automatic EQ option. Prefer `studio_sound`; `autoeq` will be removed in a future release.

studio_sound options:

Value	Behavior
`True`	Recommended. Applies aggressive studio-quality enhancement.
`"nightly"`	Advanced/experimental variant. Currently behaves similarly to `True`.
`False`	Disabled (default).

studio_sound is more aggressive than remove_noise. For most recordings, remove_noise alone is sufficient. Use studio_sound for challenging recordings in noisy environments.

Output

Option	Type	Default	Description
`export_format`	`str`	`"auto"`	Audio-only output format: `mp3`, `wav`, `flac`, `m4a`, or `auto` (matches input). Video jobs keep the original video container format.
`target_lufs`	`float`	`-16.0`	Target integrated loudness in LUFS. `-16` is the standard for podcasts
`mute_lufs`	`float`	`-120`	Gate level for LUFS measurement. Default -120 disables gating.
`export_timestamps`	`bool`	`False`	Return a JSON file with edit markers for use in a DAW or NLE

To set a loudness target, pass target_lufs to the value you want:

result = client.process("episode.mp3", target_lufs=-16.0)

Content generation

Option	Type	Default	Description
`transcription`	`bool`	`False`	Full word-by-word transcript. Language auto-detected.
`summarize`	`bool`	`False`	Chapter markers, key learnings, and episode summary. Requires `transcription=True`.
`social_content`	`bool`	`False`	Generate tweets, LinkedIn posts, and show notes. Enables `summarize` automatically.

Advanced

Option	Type	Default	Description
`signed_url`	`str`	`None`	Pre-signed PUT URL. Cleanvoice uploads directly to your storage instead of hosting the file.
`merge`	`bool`	`False`	Multi-track only. Merge all tracks into a single output file. If you need automatic level balancing for a merged multi-track job, use `automix` as the companion option.
`audio_for_edl`	`bool`	`False`	Video workflows only. Return additional uncut enhanced audio alongside the edited video for EDL/NLE work.
`video`	`bool`	`False`	Process the input as video. The SDK auto-detects common video filenames and URLs, but explicit `video=True` is safest for ambiguous or extensionless URLs.

For raw REST requests, video must be set to true for actual video editing. Otherwise the file is treated as audio-only. In the Python SDK, common video paths are auto-detected, but being explicit is still safest.

SDK-only options

Option	Type	Default	Description
`output_path`	`str`	`None`	Save the cleaned audio to this path automatically
`progress_callback`	`callable`	`None`	Called with status updates during polling

def on_progress(status):
    print(f"Status: {status}")

result = client.process(
    "episode.mp3",
    remove_noise=True,
    studio_sound=True,
    normalize=True,
    progress_callback=on_progress,
    output_path="cleaned.mp3",
)