For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Status
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
  • Voice Generation
    • Speech-to-Speech
  • Voice Creation
  • Voice Tools
      • Overview
      • Create Enhancement
      • List Enhancements
      • Get Enhancement
  • Real-Time Agents
    • Overview
  • Safety & Detection
Status
LogoLogo
On this page
  • Request Parameters
  • v2 Example (Default)
  • v1 Example (Legacy)
  • Success Response
  • Error Responses
Voice ToolsAudio Enhancement

Create Audio Enhancement

Was this page helpful?
Previous

List Audio Enhancements

Next
Built with

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.