Skip to main content

Audio Denoising — Overview

client.denoise removes background noise from audio files using Decrackle's AI denoising models.

info

Audio denoising requires a Professional plan.


Methods

MethodDescription
client.denoise.process()Upload and denoise an audio file
client.denoise.formats()List output formats available on your plan
client.denoise.jobs.list()List past denoising jobs
client.denoise.jobs.get()Get a single job by ID
client.denoise.jobs.delete()Delete a job and its files
client.denoise.jobs.refreshUrls()Refresh expired presigned URLs

How it works

  1. You upload an audio file
  2. Decrackle runs it through the denoising model
  3. You get back presigned URLs to both the original and the cleaned file
  4. Files are stored for the duration defined by your plan's storage quota
warning

Ephemeral output: On accounts where file storage is disabled, the cleaned audio URL (outputUrl) is only available for approximately 1 hour. Check outputEphemeral: true on the response to detect this case.


Supported input formats

WAV, MP3, FLAC, OGG, M4A, AAC, AIFF, OPUS, WEBM


Output formats

The denoised file is stored in a format you choose at upload time via outputFormat. Which formats are available depends on your plan — call client.denoise.formats() to check:

const { formats, defaultFormat } = await client.denoise.formats();

for (const f of formats) {
console.log(`${f.label} (.${f.extension}) — ${f.allowed ? 'available' : 'requires upgrade'}`);
}
FormatExtensionTrade-off
wav.wavUncompressed, lossless — largest files
mp3.mp3Compressed, ~10x smaller than WAV — universal compatibility
flac.flacLossless, ~50% smaller than WAV
opus_ogg.oggModern codec at 96 kbps — smallest files
warning

The format is permanent. It's applied when the file is encoded and the intermediate audio is not retained — a completed job's output cannot be re-encoded to a different format later.


Limits

LimitFreeProfessional
Max file size100 MB
Max durationUnlimited
Concurrent jobs10