POST
/
v1
/
media
/
enhance-json
Upload and enhance audio file (json)
curl --request POST \
  --url https://api.ai-coustics.io/v1/media/enhance-json \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "file_download_url": "<string>",
  "file_name": "<string>",
  "loudness_target_level": -14,
  "loudness_peak_limit": -1,
  "enhancement_level": 1,
  "transcode_kind": "MP3",
  "model_arch": "FINCH"
}'
{
  "generated_name": "e2d51dc086e24891afe8a6e8c34dd3f2"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
file_download_url
string<uri>
required

URL for the API to call via HTTP GET. If the response status code is 2xx or 3xx, the API will use the retrieved file.

Required string length: 1 - 2083
​
file_name
string
required
​
loudness_target_level
integer
required

Target loudness level, currently only LUFS is supported

Required range: -70 <= x <= -5
Examples:

-14

-28

-42

-56

-70

​
loudness_peak_limit
integer
required

Peak loudness limit, currently only dbTP is supported

Required range: -9 <= x <= 0
Examples:

-1

-3

-5

-7

-9

​
enhancement_level
number
required

Enhancement level

Required range: 0 <= x <= 1
Examples:

1

0.8

0.6

0.4

0.2

​
transcode_kind
enum<string> | null
required

Transcode kind

Available options:
MP3,
WAV
Examples:

"MP3"

"WAV"

​
model_arch
enum<string>
required

Model architecture

Available options:
FINCH,
LARK,
LARK_V2

Response

File uploaded successfully

​
generated_name
string
required