> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# 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

| Field          | Type    | Required | Notes                                                                   |
| -------------- | ------- | -------- | ----------------------------------------------------------------------- |
| `audio_file`   | file    | ✅        | Audio file to enhance (WAV, MP3, M4A, MP4, OGG, AAC, FLAC). Max 150 MB. |
| `remove_noise` | boolean | ❌        | Remove background noise. Default: `true`.                               |
| `normalize`    | boolean | ❌        | Normalize audio levels. Default: `true`.                                |
| `studio_sound` | boolean | ❌        | Apply studio-quality enhancement. Default: `true`.                      |

### Example

```bash
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'
```

### Success Response

**Status: `202 Accepted`**

```json
{
  "success": true,
  "uuid": "ENHANCEMENT_UUID",
  "status": "pending"
}
```

### Error Responses

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

> **Note**
>
> Maximum file size: 150 MB. Allowed formats: WAV, MP3, M4A, MP4, OGG, AAC, FLAC. Processing is asynchronous — poll the [Get Enhancement](/audio-tools/audio-enhancement/get) endpoint for results.