POST
/
v2
/
medias
Upload media file
curl --request POST \
  --url https://api.ai-coustics.io/v2/medias \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'media_enhancement={"loudness_target": -14, "true_peak": -1, "enhancement_level": 100, "transcode": "MP3", "enhancement_model": "LARK_V2"}' \
  --form file=@example-file
{
  "uid": "<string>",
  "uploaded_at": "<string>",
  "file_name": "<string>",
  "file_size": 123,
  "audio_codec": "<string>",
  "video_codec": "<string>",
  "duration": 123,
  "enhancement_level": 123,
  "enhancement_model": "<string>",
  "enhancement_status": "<string>",
  "enhancement_params": {}
}

Authorizations

​
X-API-Key
string
header
required

Body

multipart/form-data
​
file
file
required

The media file (audio or video) to be uploaded. The audio codec must be one of AAC LC, Opus, Vorbis, MPEG Audio, FLAC, PCM, with a maximum size of 512 MB, a minimum duration of 400 ms and a maximum duration of 120 minutes.

​
media_enhancement
object | null

Details for media enhancement (e.g., loudness)

Examples:

"{\"loudness_target\": -14, \"true_peak\": -1, \"enhancement_level\": 100, \"transcode\": \"MP3\", \"enhancement_model\": \"LARK_V2\"}"

"{\"loudness_target\": -70, \"true_peak\": -9, \"enhancement_level\": 1, \"transcode\": \"WAV\", \"enhancement_model\": \"FINCH\"}"

"{\"loudness_target\": -5, \"true_peak\": 0, \"enhancement_level\": 100, \"enhancement_model\": \"LARK\"}"

"{\"loudness_target\": -14}"

"{\"true_peak\": -1}"

"{\"enhancement_level\": 100}"

"{\"enhancement_model\": \"LARK_V2\"}"

Response

Media file uploaded successfully.

​
uid
string
required
​
uploaded_at
string
required
​
file_name
string
required
​
file_size
integer
required
​
audio_codec
string
required
​
video_codec
string | null
required
​
duration
integer
required
​
enhancement_level
integer
required
​
enhancement_model
string
required
​
enhancement_status
string
required
​
enhancement_params
object
required