Skip to main content

Gradium STT plugin guide

How to use the Gradium STT plugin for LiveKit Agents.

Available in
Python

Overview

This plugin allows you to use Gradium as an STT provider for your voice agents.

Installation

Install the plugin from PyPI:

uv add "livekit-agents[gradium]~=1.4"

Authentication

The Gradium plugin requires a Gradium API key.

Set GRADIUM_API_KEY in your .env file.

Usage

Use Gradium STT in an AgentSession or as a standalone transcription service. For example, you can use this STT in the Voice AI quickstart.

from livekit.plugins import gradium
session = AgentSession(
stt = gradium.STT(),
# ... llm, tts, etc.
)

Parameters

This section describes some of the available parameters. See the plugin reference for a complete list of all available parameters.

temperaturestringOptionalDefault: None

The temperature to be used for decoding, defaults to None aka greedy sampling.

model_namestringOptionalDefault: default

Gradium STT model to use.

model_endpointstringOptionalDefault: wss://eu.api.gradium.ai/api/speech/asr

Sets the endpoint to be used, switch to us.api.gradium.ai for US region.

Additional resources

The following resources provide more information about using Gradium with LiveKit Agents.