Gradium STT plugin guide | LiveKit Documentation

Available in

Python

Overview

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

This section includes a basic usage example and some reference material. For links to more detailed documentation, see Additional resources.

Install the plugin from PyPI:

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

The Gradium plugin requires a Gradium API key.

Set GRADIUM_API_KEY in your .env file.

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.
)

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.

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

The livekit-plugins-gradium package on PyPI.

Reference for the Gradium STT plugin.

Gradium API documentation.

Get started with LiveKit Agents and Gradium STT.