Voice ToolsAudio Enhancement

Create Audio Enhancement

POST https://app.resemble.ai/api/v2/audio_enhancements

Submit an audio file for enhancement. Processing happens asynchronously in the background.

Request Parameters

FieldTypeRequiredNotes
audio_filefile✅Audio file to enhance (WAV, MP3, M4A, MP4, OGG, AAC, FLAC). Max 150 MB.
enhancement_enginestring❌"v1" or "v2". Default: "v2".
remove_noiseboolean❌Remove background noise. Default: true. Engine v2 only.
normalizeboolean❌Normalize audio levels. Default: true. Engine v2 only.
studio_soundboolean❌Apply studio-quality enhancement. Default: true. Engine v2 only.
loudness_target_levelinteger❌Target loudness in LUFS (-70 to -5). Default: -14. Engine v1 only.
loudness_peak_limitinteger❌Peak limit in dBTP (-9 to 0). Default: -1. Engine v1 only.
enhancement_levelfloat❌Enhancement intensity (0.0 to 1.0). Default: 1.0. Engine v1 only.

v2 Example (Default)

$curl -X POST 'https://app.resemble.ai/api/v2/audio_enhancements' \
>  -H 'Authorization: Bearer YOUR_API_TOKEN' \
>  -F 'audio_file=@your_audio_file.wav' \
>  -F 'remove_noise=true' \
>  -F 'normalize=true' \
>  -F 'studio_sound=true'

v1 Example (Legacy)

$curl -X POST 'https://app.resemble.ai/api/v2/audio_enhancements' \
>  -H 'Authorization: Bearer YOUR_API_TOKEN' \
>  -F 'audio_file=@your_audio_file.mp3' \
>  -F 'enhancement_engine=v1' \
>  -F 'enhancement_level=0.8' \
>  -F 'loudness_target_level=-14' \
>  -F 'loudness_peak_limit=-3'

Success Response

Status: 202 Accepted

1{
2  "success": true,
3  "uuid": "ENHANCEMENT_UUID",
4  "status": "pending"
5}

Error Responses

StatusConditionExample
400Missing audio file{"success": false, "message": "audio_file parameter is required"}
400Unsupported format{"success": false, "message": "Invalid audio file type: audio/pdf. Only WAV, MP3, M4A, MP4, OGG, AAC, and FLAC files are allowed."}
400File too large{"success": false, "message": "File size exceeds maximum limit of 150MB"}
403Plan doesn’t include feature{"success": false, "message": "Your plan doesn't support audio enhancements."}
403Monthly usage limit exceeded{"success": false, "message": "You've reached your plan's usage limit for this month. Please upgrade your plan to continue"}

Maximum file size: 150 MB. Allowed formats: WAV, MP3, M4A, MP4, OGG, AAC, FLAC. Processing is asynchronous — poll the Get Enhancement endpoint for results.