Vocal Remover

Echo Remover

Noise Reducer

Audio Enhancement API Documentation

Overview

The Audio Enhancement API allows you to improve the quality of audio files through various enhancement modes. The API follows a job-based workflow where you submit audio for processing, check the status, and retrieve the enhanced audio when ready.

Submit

Upload audio files with your preferred enhancement mode

Process

Our system processes your audio with advanced algorithms

Check

Monitor job status until processing is complete

Download

Retrieve your enhanced audio file

Authentication

All API requests require authentication using an API key. Your API key should be included in the request headers.

Required Headers

x-api-key
Your unique API key (Get from your dashboard)
x-origin
"api.audioenhancer.ai"
// Example request with authentication headers
fetch('https://api.audioenhancer.ai/', {
  method: 'POST',
  headers: {
    'api-key': '{api-key}',
    'origin': 'api.audioenhancer.ai'
  },
  body: formData
});

Endpoints

Base URL: https://api.audioenhancer.ai

POST

/audio-enhance

Submit an audio file for enhancement processing.

Request

Headers
x-api-key
Your unique API key (Get from your dashboard)
x-origin
"api.audioenhancer.ai"
Body (multipart/form-data)
enhance_type
String. Enhancement mode to apply.
Options: "clean_up_the_speech", "reduce_background_noise", "fix_the_loudness_and_levels", "plosive_remover", "sibilance_reduction", "remove_background_noise", "remove_echo"
media
File. Audio file to enhance.
Supported formats: .m4a, .mp4, .3gp, .m4b, .aac, .m4p, .m4r, .m4v, .aif, .aiff, .aifc, .avi, .mov, .qt, .mp3, .opus, .ogg, .wav
Maximum size: 4GB
Maximum file duration: 3 Hours

Response

{
    "error": false,
    "flag": "success",
    "message": "Media submitted successfully!",
    "output": {
        "job_id": "yguqikxhum4jtias462g2fqbayu0vgh9" // example job id
    }
}

Code Examples

JavaScript
Python
cURL
// Submit a new audio enhancement job
const myHeaders = new Headers();
myHeaders.append("x-api-key", "{api-key}");
myHeaders.append("x-origin", "api.audioenhancer.ai");

const formdata = new FormData();
formdata.append("enhance_type", "{enhancement_mode}");
formdata.append("media", fileInput.files[0], "/path/to/file.wav");

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: formdata,
  redirect: "follow"
};

fetch("https://api.audioenhancer.ai/audio-enhance", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

# Submit a new audio enhancement job
import requests

url = "https://api.audioenhancer.ai/audio-enhance"

payload = {'enhance_type': '{enhancement_mode}'}
files=[
  ('media',('test301.wav',open("/path/to/file.wav",'rb'),'audio/wav'))
]
headers = {
  'x-api-key': '{api-key}',
  'x-origin': 'api.audioenhancer.ai'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

# Submit a new audio enhancement job
curl --location 'https://api.audioenhancer.ai/audio-enhance' \
--header 'x-api-key: {api-key}' \
--header 'x-origin: api.audioenhancer.ai' \
--form 'enhance_type="{enhancement_mode}"' \
--form 'media=@"/path/to/file.wav"'

Base URL: https://api.audioenhancer.ai

GET

/check-status/{job_id}

Check the status of a submitted enhancement job.

Request

Headers
x-api-key
Your unique API key (Get from your dashboard)
x-origin
"api.audioenhancer.ai"
Path Parameters
job_id
ID of the job to check

Response

Processing
Completed
Failed
{
    "error": false,
    "flag": "success",
    "message": "Job id fetched successfully!",
    "output": {
        "enhance_type": "fix_the_loudness_and_levels",
        "enhanced": null,
        "enhanced_audio_down": null,
        "enhanced_audio_url": null,
        "file_duration": 3.0,
        "filename": "test301.wav",
        "job_id": "yguqikxhum4jtias462g2fqbayu0vgh9",
        "mode": "fix_the_loudness_and_levels",
        "original_audio_down": "https://apinest.dev/filemanager/audios/original/download.php?file=976f54e557974af80138d0200006594b.wav&name=test301.wav",
        "original_audio_url": "https://apinest.dev/filemanager/audios/original/976f54e557974af80138d0200006594b.wav",
        "status": "enhancing_started" // "finalizing_results", "processing_started"
    }
}
{
    "error": false,
    "flag": "success",
    "message": "Job id fetched successfully!",
    "output": {
        "enhance_type": "fix_the_loudness_and_levels",
        "enhanced": "976f54e557974af80138d0200006594b.wav",
        "enhanced_audio_down": "https://apinest.dev/filemanager/audios/enhanced/download.php?file=976f54e557974af80138d0200006594b.wav&name=test301_enhanced.wav",
        "enhanced_audio_url": "https://apinest.dev/filemanager/audios/enhanced/976f54e557974af80138d0200006594b.wav",
        "file_duration": 3.0,
        "filename": "test301.wav",
        "job_id": "yguqikxhum4jtias462g2fqbayu0vgh9",
        "mode": "fix_the_loudness_and_levels",
        "original_audio_down": "https://apinest.dev/filemanager/audios/original/download.php?file=976f54e557974af80138d0200006594b.wav&name=test301.wav",
        "original_audio_url": "https://apinest.dev/filemanager/audios/original/976f54e557974af80138d0200006594b.wav",
        "status": "enhancing_completed"
    }
}
{
    "error": false,
    "flag": "success",
    "message": "Job id fetched successfully!",
    "output": {
        "enhance_type": "fix_the_loudness_and_levels",
        "enhanced": null,
        "enhanced_audio_down": null,
        "enhanced_audio_url": null,
        "file_duration": 3.0,
        "filename": "test301.wav",
        "job_id": "yguqikxhum4jtias462g2fqbayu0vgh9",
        "mode": "fix_the_loudness_and_levels",
        "original_audio_down": "https://apinest.dev/filemanager/audios/original/download.php?file=976f54e557974af80138d0200006594b.wav&name=test301.wav",
        "original_audio_url": "https://apinest.dev/filemanager/audios/original/976f54e557974af80138d0200006594b.wav",
        "status": "processing_failed" // "enhancing_failed"
    }
}

Code Examples

JavaScript
Python
cURL
// Check status against job
const requestOptions = {
  method: "GET",
  redirect: "follow"
};

fetch("https://api.audioenhancer.ai/check-status/{job_id}", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

# Check status against job
import requests
url = "https://api.audioenhancer.ai/check-status/{job_id}"
response = requests.request("GET", url)
print(response.text)

# Check status against job
curl --location 'https://api.audioenhancer.ai/check-status/{job_id}'

Base URL: https://api.audioenhancer.ai

GET

/delete-job/{job_id}

Delete a job and associated files.

Request

Headers
x-api-key
Your unique API key (Get from your dashboard)
x-origin
"api.audioenhancer.ai"
Path Parameters
job_id
ID of the job to delete

Response

{job_id} job ID deleted successfully.

Code Examples

JavaScript
Python
cURL
// Delete job
const myHeaders = new Headers();
myHeaders.append("x-api-key", "{api-key}");
myHeaders.append("x-origin", "api.audioenhancer.ai");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://api.audioenhancer.ai/delete-job/{job_id}", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

# Delete job
import requests
url = "https://api.audioenhancer.ai/delete-job/{job_id}"
headers = {
  'x-api-key': '{api-key}',
  'x-origin': 'api.audioenhancer.ai'
}
response = requests.request("GET", url, headers=headers)
print(response.text)

# Delete job
curl --location 'https://api.audioenhancer.ai/delete-job/{job_id}' \
--header 'x-api-key: {api-key}' \
--header 'x-origin: api.audioenhancer.ai'
GET

/credits

Check your account's remaining credits.

Request

Headers
x-api-key
Your unique API key (Get from your dashboard)
x-origin
"api.audioenhancer.ai"

Response

{
    "data": {
        "activatedAt": "01/01/2025 12:00:00",
        "credits": 25.68,
        "email": "test+bg20x@example.com",
        "orderStatus": "active",
        "productName": "API Credits - Audioenhancer.ai",
        "seconds": "1540",
        "xuid": "{user-registered-id}"
    },
    "error": false,
    "flag": "success",
    "message": "Success"
}