Noise Reduction

Reduce background noise in audio, such as wind, air conditioner hum, or ambient room noise, to make speech clearer.

Create Task

Basic Information

Item	Value
Request Method	POST
Request Path	/task/audio_noise_reduce
Content-Type	application/json
Authentication	Raw API key in the Authorization header

Request Body

Parameter	Type	Required	Default	Description
file_id	string	Yes	-	Uploaded audio or video file ID
prop_decrease	number	No	0.8	Noise reduction strength in the range 0.0~1.0

Request Example

curl -X POST https://api.ai-mcn.tv:10000/task/audio_noise_reduce \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "prop_decrease": 0.8
  }'

Success Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "audio_noise_reduce",
    "status": "queued"
  }
}

---

Query Task Result

Basic Information

Item	Value
Request Method	GET
Request Path	/task/audio_noise_reduce/{task_id}
Authentication	Raw API key in the Authorization header

Output Result (output_result)

Parameter	Type	Description
file_id	string	Processed audio file ID
download_url	string	Download path for the processed audio

Success Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output_denoised.wav"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:12Z"
  }
}

Error Codes

Error Code	HTTP Status	Description	Resolution
6013	400	Missing file_id	Pass the file_id field
6004	404	File not found	Verify the file_id
6502	401	Authentication failed	Check the Authorization header
6202	402	Insufficient balance	Recharge in the Dashboard