> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gladia

> Gladia provides state-of-the-art audio transcription and intelligence services through a simple API, enabling real-time and asynchronous transcription, translation, and audio analysis.

![Gladia logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/gladia.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=42a8f8234adfae47550f3ac5c8b8f365)

* **Category:** audio & speech
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `GLADIA`
* **Version:** 20261014\_00

## Tools

> [accordion] Delete Live Session
>
> **Slug:** `GLADIA_DELETE_LIVE_SESSION`
>
> Tool to delete a live transcription session and all its associated data (audio file, transcription). Use when permanently removing a live session from Gladia.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the live transcription session to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Pre-recorded Job
>
> **Slug:** `GLADIA_DELETE_PRE_RECORDED_JOB`
>
> Tool to delete a pre-recorded transcription job and all its associated data (audio file, transcription). Use when permanently removing a transcription job from Gladia.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the pre-recorded transcription job to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get live transcription result
>
> **Slug:** `GLADIA_GET_LIVE_TRANSCRIPTION_RESULT`
>
> Tool to retrieve metadata and results of a live transcription job. Use when you need detailed status or results for a specific live transcription session.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the live transcription job
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pre-recorded Job
>
> **Slug:** `GLADIA_GET_PRE_RECORDED_JOB`
>
> Tool to retrieve a pre-recorded transcription job's metadata, status, and results by ID. Use when checking the status or retrieving results of a specific pre-recorded job.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Id of the pre recorded job
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Transcription Audio File (Deprecated)
>
> **Slug:** `GLADIA_GET_TRANSCRIPTION_AUDIO_FILE_DEPRECATED`
>
> DEPRECATED - use GET /v2/pre-recorded/\{id}/file instead. Download the audio file used for a transcription job. Use when you need to retrieve the original audio file associated with a specific transcription job ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Id of the transcription job
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Initiate Live Transcription Session
>
> **Slug:** `GLADIA_INITIATE_LIVE_SESSION`
>
> Initiates a live (real-time) transcription session with Gladia's API. Returns a WebSocket URL that you can connect to for streaming audio data in real-time. The WebSocket URL includes an embedded authentication token and should be used promptly. After initiating, connect to the returned WebSocket URL and send audio chunks. Use GET /v2/live/\{id} to retrieve the full transcription results after the session ends.
>
> #### Input Parameters
>
> **model** `string ("solaria-1" | "solaria-2")`
>
> Transcription model to use. 'solaria-1' is the default model. 'solaria-2' may require a higher subscription plan.
>
> **region** `string ("us-west" | "eu-west")`
>
> Processing region for the session. Use 'us-west' for US West or 'eu-west' for EU West. If not specified, the default region is used.
>
> **callback** `boolean`
>
> Enable callback notifications. When true, configure callback\_config to specify the callback URL.
>
> **channels** `integer`
>
> Number of audio channels. Use 1 for mono (most speech), 2 for stereo. Maximum 8 channels supported.
>
> **encoding** `string ("wav/pcm" | "wav/alaw" | "wav/ulaw")`
>
> Audio encoding format for the stream. Use 'wav/pcm' for raw PCM, 'wav/alaw' for A-law, or 'wav/ulaw' for µ-law encoding.
>
> **bit\_depth** `integer ("8" | "16" | "24" | "32")`
>
> Audio sample bit depth. Common values: 8-bit for telephony, 16-bit for standard audio, 24/32-bit for high-quality audio.
>
> **endpointing** `number`
>
> Duration of silence in seconds that triggers end of utterance. Lower values (0.01-0.1) for responsive transcription, higher values (0.5-2.0) for longer pauses.
>
> **sample\_rate** `integer ("8000" | "16000" | "32000" | "44100" | "48000")`
>
> Audio sample rate in Hz. Use 8000 for telephony, 16000 for speech, 44100/48000 for high-fidelity audio.
>
> **pre\_processing** `object`
>
> Pre-processing settings for audio enhancement and speech activity detection thresholds.
>
> **callback\_config** `object`
>
> Callback delivery configuration. Required if callback is true. Specify callback URL and which events to send.
>
> **custom\_metadata** `object`
>
> Custom key/value metadata to attach to the session for tracking or identification purposes.
>
> **language\_config** `object`
>
> Language configuration object. Example: \{'languages': \['en']} for English, or enable code-switching for multilingual audio.
>
> **messages\_config** `object`
>
> Configuration for which message types to receive over WebSocket (transcripts, partial results, etc.).
>
> **post\_processing** `object`
>
> Post-processing settings for summarization and chapterization of the transcript after the session ends.
>
> **realtime\_processing** `object`
>
> Realtime processing options including custom vocabulary, translation, named entity recognition (NER), and sentiment analysis.
>
> **maximum\_duration\_without\_endpointing** `number`
>
> Maximum duration in seconds before forcing an utterance end, even without detecting silence. Range: 5-60 seconds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Initiate Pre-Recorded Transcription
>
> **Slug:** `GLADIA_INITIATE_PRE_RECORDED_TRANSCRIPTION`
>
> Tool to initiate a pre-recorded transcription job. Use when you have an audio URL and need asynchronous transcription results.
>
> #### Input Parameters
>
> **model** `string ("solaria-1" | "solaria-2")`
>
> Transcription model. 'solaria-1' (default) or 'solaria-2' (may require higher tier plan).
>
> **callback** `boolean`
>
> Enable webhook callback when transcription completes.
>
> **audio\_url** `string` *required*
>
> URL to an audio or video file. Can be a public URL or a Gladia file URL from the upload endpoint (format: [https://api.gladia.io/file/\&lt;id](https://api.gladia.io/file/\&lt;id)>).
>
> **sentences** `boolean`
>
> Enable sentence segmentation for better readability.
>
> **subtitles** `boolean`
>
> Enable subtitle generation. Set to true to generate SRT/VTT files.
>
> **diarization** `boolean`
>
> Enable speaker diarization to identify who said what. Set to true to detect speakers.
>
> **translation** `boolean`
>
> Enable translation of transcription. Set to true to translate to other languages.
>
> **summarization** `boolean`
>
> Enable summarization of transcription. Set to true to get a summary.
>
> **callback\_config** `object`
>
> Configuration for webhook callback when transcription completes.
>
> **custom\_metadata** `object`
>
> Arbitrary metadata to attach to the job for tracking and organization.
>
> **language\_config** `object`
>
> Configuration for preferred language handling.
>
> **subtitles\_config** `object`
>
> Configuration for subtitle generation.
>
> **diarization\_config** `object`
>
> Configuration for speaker diarization.
>
> **translation\_config** `object`
>
> Configuration for translation of transcription.
>
> **punctuation\_enhanced** `boolean`
>
> Enable enhanced punctuation and casing for cleaner transcripts.
>
> **summarization\_config** `object`
>
> Configuration for summarization of transcription.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List live transcription jobs
>
> **Slug:** `GLADIA_LIST_LIVE_TRANSCRIPTIONS`
>
> Tool to list live transcription jobs. Use when you need an overview of live transcription sessions with optional filtering and pagination. Use after setting up live transcription.
>
> #### Input Parameters
>
> **date** `string`
>
> Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
>
> **limit** `integer`
>
> Max number of items to return.
>
> **offset** `integer`
>
> The starting point for pagination; 0 starts from the first item.
>
> **status** `array`
>
> Filter by item status; accepts multiple values. Valid statuses: 'queued', 'processing', 'done', 'error'.
>
> **after\_date** `string`
>
> Filter for items after the specified ISO date-time (use with before\_date for a range).
>
> **before\_date** `string`
>
> Include items that occurred before the specified ISO date-time.
>
> **custom\_metadata** `object`
>
> Filter by custom metadata object (e.g., \{'user': 'John Doe'}).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pre-Recorded Jobs
>
> **Slug:** `GLADIA_LIST_PRE_RECORDED_JOBS`
>
> Tool to list all pre-recorded transcription jobs matching the query parameters. Use when you need to retrieve a paginated list of transcription jobs with optional filtering by date, status, or custom metadata.
>
> #### Input Parameters
>
> **date** `string`
>
> Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
>
> **limit** `integer`
>
> The maximum number of items to return. Useful for pagination and controlling data payload size.
>
> **offset** `integer`
>
> The starting point for pagination. A value of 0 starts from the first item.
>
> **status** `array`
>
> Filter the list based on item status. Accepts multiple values from the predefined list.
>
> **after\_date** `string`
>
> Filter for items after the specified date. Use with `before_date` for a range. Date in ISO format.
>
> **before\_date** `string`
>
> Include items that occurred before the specified date in ISO format.
>
> **custom\_metadata** `object`
>
> Custom metadata filter to match jobs, e.g., \{"user": "John Doe"}.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Audio/Video File
>
> **Slug:** `GLADIA_UPLOAD_AUDIO_VIDEO_FILE`
>
> Upload an audio or video file to Gladia for speech-to-text transcription. Returns a URL that can be used with the pre-recorded transcription endpoint. Supports common audio formats (WAV, MP3, FLAC, OGG) and video formats (MP4, MKV, etc.).
>
> #### Input Parameters
>
> **file** `object` *required*
>
> The audio or video file to upload. Supports common formats like WAV, MP3, FLAC, MP4, etc.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
