Skip to main content
POST
/
v2
/
upload
Upload an audio file or provide an audio URL for processing
curl --request POST \
  --url https://api.gladia.io/v2/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-gladia-key: <api-key>' \
  --form audio='@example-file'
{
  "audio_url": "https://api.gladia.io/file/6c09400e-23d2-4bd2-be55-96a5ececfa3b",
  "audio_metadata": {
    "id": "6c09400e-23d2-4bd2-be55-96a5ececfa3b",
    "filename": "short-audio-en-16000.wav",
    "extension": "wav",
    "size": 365702,
    "audio_duration": 4.145782,
    "number_of_channels": 1,
    "source": "http://files.gladia.io/example/audio-transcription/split_infinity.wav"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gladia.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-gladia-key
string
header
required

Your personal Gladia API key

Body

​
audio
file

The file to be uploaded. This should be an audio or video file.

Response

200 - application/json
​
audio_url
string<uri>
required

Uploaded audio file Gladia URL

Example:

"https://api.gladia.io/file/6c09400e-23d2-4bd2-be55-96a5ececfa3b"

​
audio_metadata
object
required

Uploaded audio file detected metadata