Gladia

Learn how to use Gladia with Composio

Overview

SLUG: GLADIA

Description

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.

Authentication Details

generic_api_key
stringRequired

Connecting to Gladia

Create an auth config

Use the dashboard to create an auth config for the Gladia toolkit. This allows you to connect multiple Gladia accounts to Composio for agents to use.

1

Select App

Navigate to Gladia.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Gladia Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4gladia_auth_config_id = "ac_YOUR_GLADIA_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Gladia for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, gladia_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Gladia toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["GLADIA"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Get live transcription result

Description

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.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Pre-recorded Transcription Result

Description

Tool to retrieve metadata for a pre-recorded transcription job. Use when checking the status or retrieving results of a specific job ID.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Initiate Live Transcription Session

Description

Tool to initiate a live transcription session. Use before streaming audio to get a WebSocket URL.

Action Parameters

bit_depth
integerDefaults to 16
callback
boolean
callback_config
object
channels
integerDefaults to 1
custom_metadata
object
encoding
stringDefaults to wav/pcm
endpointing
numberDefaults to 0.05
language_config
object
maximum_duration_without_endpointing
numberDefaults to 5
messages_config
object
model
stringDefaults to solaria-1
post_processing
object
pre_processing
object
realtime_processing
object
region
string
sample_rate
integerDefaults to 16000

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Initiate Pre-Recorded Transcription

Description

Tool to initiate a pre-recorded transcription job. Use when you have an audio URL and need asynchronous transcription results.

Action Parameters

audio_url
stringRequired
custom_metadata
object
diarization_config
object
language_config
object
model
stringDefaults to solaria-1
subtitles_config
object
summarization_config
object
translation_config
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List live transcription jobs

Description

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.

Action Parameters

after_date
string
before_date
string
custom_metadata
object
date
string
limit
integerDefaults to 20
offset
integer
status
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Gladia List Pre-Recorded Transcriptions

Description

Tool to list pre-recorded transcription jobs with optional filters. Use after submitting or querying jobs to retrieve paginated results.

Action Parameters

after_date
string
before_date
string
custom_metadata
object
date
string
limit
integerDefaults to 20
offset
integer
status
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Upload Audio/Video File

Description

Tool to upload an audio or video file to Gladia's servers. Use when preparing a file for transcription.

Action Parameters

file_path
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired