LiveKit docs › Models › STT › Additional models › Gradium

---

# Gradium STT plugin guide

> How to use the Gradium STT plugin for LiveKit Agents.

Available in:
- [ ] Node.js
- [x] Python

## Overview

This plugin allows you to use [Gradium](https://gradium.ai) as an STT provider for your voice agents.

### Installation

Install the plugin from PyPI:

```shell
uv add "livekit-agents[gradium]~=1.5"


```

### Authentication

The Gradium plugin requires a [Gradium API key](https://eu.api.gradium.ai/studio).

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](https://docs.livekit.io/agents/start/voice-ai.md).

```python
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](https://docs.livekit.io/reference/python/livekit/plugins/gradium/index.html.md#livekit.plugins.gradium.STT) for a complete list of all available parameters.

- **`temperature`** _(string)_ (optional) - Default: `None`: The temperature to be used for decoding, defaults to None aka greedy sampling.

- **`model_name`** _(string)_ (optional) - Default: `default`: Gradium STT model to use.

- **`model_endpoint`** _(string)_ (optional) - Default: `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.

- **[Python package](https://pypi.org/project/livekit-plugins-gradium/)**: The `livekit-plugins-gradium` package on PyPI.

- **[Plugin reference](https://docs.livekit.io/reference/python/livekit/plugins/gradium/index.html.md#livekit.plugins.gradium.STT)**: Reference for the Gradium STT plugin.

- **[Gradium docs](https://gradium.ai/api_docs.html)**: Gradium API documentation.

- **[Gradium TTS](https://docs.livekit.io/agents/models/tts/gradium.md)**: Guide to the Gradium TTS plugin with LiveKit Agents.

---

This document was rendered at 2026-06-07T11:35:10.965Z.
For the latest version of this document, see [https://docs.livekit.io/agents/models/stt/gradium.md](https://docs.livekit.io/agents/models/stt/gradium.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).