Audio Cleaner (AudioEnhance) API - Integration Guide

Overview

AudioEnhance is an API for audio enhancement and noise reduction. It supports async processing for long-duration, large-size, and multi-format audio files, making it suitable for improving clarity and intelligibility in scenarios like meetings and lectures.

Key Features

• Extended duration support: up to 3 hours (10,800 seconds) per file for long meetings, lectures, and more.
• Large-file friendly: supports files up to 10MB and multiple audio sources.
• Rich enhancement capabilities: covers enhancement, denoising, and vocal-related scenarios.
• Broad format compatibility: supports 20+ mainstream audio/video formats.
• Transparent billing: credits are charged by actual duration (rounded up to the nearest minute).

Authentication

All API requests require api-key using an API key. Include your API key in the request header:

API Host: https://audiocleaner.ai/

api-key: YOUR_API_KEY

Pricing Rules

This audio enhancement service is billed based on total audio duration (in seconds). Actual deduction logic and pricing follow backend rules.

Each task must include audio duration. The system automatically calculates billable time (credit_time), rounded up to the nearest minute (e.g., 61 seconds is billed as 2 minutes).

1. Create Audio Enhancement Task

Endpoint

POST /audio/api/v1/api-keys/enhance/task/create

Request Headers

Request Parameters (Body · JSON)

enhance_type Field Examples

Parameter Example

{
  "enhance_type": {
    "remove_background_audio": true,
    "remove_echo": true,
    "autoid": true,
    "remove_noise": true,
    "long_silences": true,
    "mouth_sounds": true,
    "stutters": true,
    "fillers": true,
    "hesitations": true,
    "keep_music": true,
    "autoeq": true,
    "normalize": true,
    "studio_sound": true,
    "remove_reverb": true
  },
  "inputurl": "https://resource.audiocleaner.ai/acweb/audio/audiocleaner_AI_origional.mp3"
}

Response Format (Unified Response)

{
  "code": 100000,
  "data": {
    "job_id": "33b6251d7ba94edea8361c318736e746"
  },
  "message": "Request Success"
}

Field Descriptions

• code: Numeric status code.
• 100000: request succeeded; 100100: insufficient credits; 101002: invalid API key; 101003: rate limit exceeded; 101004: concurrency limit exceeded; 101005: API key disabled; 101006: API key not activated.
• data: Result object. Common fields include job_id (task ID), output (legacy model output URL), and model (returned in some scenarios; 2 indicates the new model).
• message: Human-readable message describing the status.

Common Code Reference

Example Request

curl --location --request POST 'https://audiocleaner.ai/audio/api/v1/api-keys/enhance/task/create' \
  --header 'Content-Type: application/json' \
  --header 'api-key: YOUR_API_KEY' \
  --data-raw '{
    "inputurl": "https://resource.audiocleaner.ai/acweb/audio/audiocleaner_AI_origional.mp3",
    "enhance_type": {
      "remove_background_audio": true,
      "remove_echo": true,
      "autoid": true,
      "remove_noise": true,
      "long_silences": true,
      "mouth_sounds": true,
      "stutters": true,
      "fillers": true,
      "hesitations": true,
      "keep_music": true,
      "autoeq": true,
      "normalize": true,
      "studio_sound": true,
      "remove_reverb": true
    }
  }'

2. Query Task Status (New Model)

Endpoint

POST /audio/api/v1/api-keys/enhance/task/get

Request Headers

Request Parameters

Response Example

{
  "code": 100000,
  "data": {
    "status": "waiting",
    "result": "https://.../output.mp3",
    "file_size": 1234567
  }
}

Response Field Descriptions

Response Code Reference

Example Request

curl --location --request POST 'https://audiocleaner.ai/audio/api/v1/api-keys/enhance/task/get' \
  --header 'Content-Type: application/json' \
  --header 'api-key: YOUR_API_KEY' \
  --data-raw '{
    "job_id": "YOUR_JOB_ID"
  }'

Use Cases

• Improve audio quality in meetings, podcasts, and similar scenarios (e.g., denoise and normalize).
• Batch enhancement for multiple files by creating one task per audio file.
• Support for multiple audio sources and file formats.

FAQ