Gladia
    Gladia
    • List Transcriptions
      GET
    • Create Transcription
      POST
    • Get Transcription
      GET
    • Delete Transcription
      DELETE
    • Download Transcription audio
      GET
    • Create Upload
      POST

      Create Transcription

      Develop Env
      https://dev.your-api-server.com
      Develop Env
      https://dev.your-api-server.com
      POST
      /v2/transcription
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST 'https://dev.your-api-server.com/v2/transcription' \
      --header 'x-gladia-key: <api-key>' \
      --header 'Content-Type: application/json' \
      --data-raw '{
        "context_prompt": "<string>",
        "custom_vocabulary": [
          "<string>"
        ],
        "detect_language": true,
        "enable_code_switching": true,
        "code_switching_config": {
          "languages": [
            "af"
          ]
        },
        "language": "en",
        "callback_url": "http://callback.example",
        "subtitles": true,
        "subtitles_config": {
          "formats": [
            "srt"
          ]
        },
        "diarization": true,
        "diarization_config": {
          "number_of_speakers": 2,
          "min_speakers": 1,
          "max_speakers": 2
        },
        "translation": true,
        "translation_config": {
          "target_languages": [
            "en"
          ],
          "model": "base"
        },
        "summarization": true,
        "summarization_config": {
          "type": "general"
        },
        "moderation": true,
        "named_entity_recognition": true,
        "chapterization": true,
        "name_consistency": true,
        "custom_spelling": true,
        "custom_spelling_config": {
          "spelling_dictionary": {
            "Gettleman": [
              "gettleman"
            ],
            "SQL": [
              "Sequel"
            ]
          }
        },
        "structured_data_extraction": true,
        "structured_data_extraction_config": {
          "classes": [
            "Persons",
            "Organizations"
          ]
        },
        "sentiment_analysis": true,
        "audio_to_llm": true,
        "audio_to_llm_config": {
          "prompts": [
            "Extract the key points from the transcription"
          ]
        },
        "custom_metadata": {},
        "sentences": true,
        "display_mode": true,
        "audio_url": "http://files.gladia.io/example/audio-transcription/split_infinity.wav"
      }'
      Response Response Example
      200 - Success
      {
        "id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
        "result_url": "https://api.gladia.io/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab"
      }

      Request

      Header Params
      Content-Type
      string 
      required
      Example:
      application/json
      x-gladia-key
      string 
      required
      Example:
      <api-key>
      Body Params application/json
      context_prompt
      string 
      optional
      custom_vocabulary
      array[string]
      optional
      detect_language
      boolean 
      optional
      enable_code_switching
      boolean 
      optional
      code_switching_config
      object 
      optional
      languages
      array[string]
      required
      language
      string 
      optional
      callback_url
      string 
      optional
      subtitles
      boolean 
      optional
      subtitles_config
      object 
      optional
      formats
      array[string]
      required
      diarization
      boolean 
      optional
      diarization_config
      object 
      optional
      number_of_speakers
      integer 
      required
      min_speakers
      integer 
      required
      max_speakers
      integer 
      required
      translation
      boolean 
      optional
      translation_config
      object 
      optional
      target_languages
      array[string]
      required
      model
      string 
      required
      summarization
      boolean 
      optional
      summarization_config
      object 
      optional
      type
      string 
      required
      moderation
      boolean 
      optional
      named_entity_recognition
      boolean 
      optional
      chapterization
      boolean 
      optional
      name_consistency
      boolean 
      optional
      custom_spelling
      boolean 
      optional
      custom_spelling_config
      object 
      optional
      spelling_dictionary
      object 
      required
      structured_data_extraction
      boolean 
      optional
      structured_data_extraction_config
      object 
      optional
      classes
      array[string]
      required
      sentiment_analysis
      boolean 
      optional
      audio_to_llm
      boolean 
      optional
      audio_to_llm_config
      object 
      optional
      prompts
      array[string]
      required
      custom_metadata
      object 
      optional
      sentences
      boolean 
      optional
      display_mode
      boolean 
      optional
      audio_url
      string 
      required
      URL to a Gladia file or to an external audio or video file
      Examples

      Responses

      🟢200Success
      application/json
      Body
      id
      string 
      required
      result_url
      string 
      required
      🟠400Bad Request
      Modified at 2024-07-30 09:02:56
      Previous
      List Transcriptions
      Next
      Get Transcription
      Built with