​
Upload your file

This step is optional if you are already working with audio URLs.

If you’re working with audio or video files, you’ll need to upload it first using our POST /v2/upload endpoint with multipart/form-data content-type since the POST /v2/pre-recorded endpoint only accept audio URLs.

If you are already using audio file URLs, proceed to the next step.

curl --request POST \
  --url https://api.gladia.io/v2/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-gladia-key: YOUR_GLADIA_API_KEY' \
  --form audio=@/path/to/your/audio/conversation.wav

Example response:

{
  "audio_url": "https://api.gladia.io/file/636c70f6-92c1-4026-a8b6-0dfe3ecf826f",
  "audio_metadata": {
    "id": "636c70f6-92c1-4026-a8b6-0dfe3ecf826f",
    "filename": "conversation.wav",
    "extension": "wav",
    "size": 99515383,
    "audio_duration": 4146.468542,
    "number_of_channels": 2
  }
}

We will now proceed to the next steps using the returned audio_url.

​
Transcribe

We’ll now POST the transcription request to Gladia’s API using the POST /v2/pre-recorded endpoint.

/v2/pre-recorded only accept application/json as Content-Type.

  curl --request POST \
    --url https://api.gladia.io/v2/pre-recorded \
    --header 'Content-Type: application/json' \
    --header 'x-gladia-key: YOUR_GLADIA_API_KEY' \
    --data '{
    "audio_url": "YOUR_AUDIO_URL",
    "diarization": true,
    "diarization_config": {
      "number_of_speakers": 3,
      "min_speakers": 1,
      "max_speakers": 5
    },
    "translation": true,
    "translation_config": {
      "model": "base",
      "target_languages": ["fr", "en"],
      "context_adaptation": true,
      "context": "Business meeting discussing quarterly results",
      "informal": false
    },
    "subtitles": true,
    "subtitles_config": {
      "formats": ["srt", "vtt"]
    },
    "detect_language": true,
    "enable_code_switching": false
    }
  '

You’ll get an instant response from the request with an id and a result_url. The id is your transcription ID that you will use to get your transcription result once it’s done.

result_url is returned for convenience. This is a pre-built url with your transcription id in it that you can use to get your result in the next step.

​
Get the transcription result

You can get your transcription results in 3 different ways:

​
Full sample

You can find a complete sample in our Github repository: