Skip to main content
1

Get an API key

Create an account and copy your API key from the dashboard.
2

Upload media for enhancement

Send a media file (audio or video) and optional enhancement parameters.
curl -sS -X POST "https://api.ai-coustics.io/v2/medias" \
  -H "X-API-Key: $AICOUSTICS_API_KEY" \
  -F file=@"./example.wav" \
  -F media_enhancement='{ "loudness_target": -14, "true_peak": -1, "enhancement_level": 100, "enhancement_model": "LARK_V2", "transcode": "WAV" }'

{
  "uid": "med_7f6c7b1c2d",
  "uploaded_at": "2025-09-11T10:30:00Z",
  "file_name": "example.wav",
  "file_size": 4821934,
  "audio_codec": "PCM",
  "video_codec": null,
  "duration": 12345,
  "enhancement_level": 100,
  "enhancement_model": "LARK_V2",
  "enhancement_status": "PROCESSING",
  "enhancement_params": { "loudness_target": -14, "true_peak": -1, "transcode": "WAV" }
}
Supported audio codecs include PCM, MPEG Audio, Vorbis, Opus, AAC LC, FLAC. Maximum size is 512 MB and audio duration up to 120 minutes. See the API Reference for details.
3

Poll metadata until processing completes

Use the uid to check status.
curl -sS -X GET "https://api.ai-coustics.io/v2/medias/$UID/metadata" \
  -H "X-API-Key: $AICOUSTICS_API_KEY"

{
  "uid": "med_7f6c7b1c2d",
  "enhancement_status": "COMPLETED",
  "enhancement_model": "LARK_V2",
  "enhancement_level": 100,
  "duration": 12345,
  "enhancement_params": { "loudness_target": -14, "true_peak": -1, "transcode": "WAV" }
}
4

Download the enhanced file

When status is COMPLETED, download the processed media.
curl -sS -L -X GET "https://api.ai-coustics.io/v2/medias/$UID/file" \
  -H "X-API-Key: $AICOUSTICS_API_KEY" \
  --output enhanced.wav
You should now have enhanced.wav saved locally.