Deepgram

Deepgram is a speech-to-text plugin. It transcribes the caller’s audio into text for the LLM.

Setup

Set your Deepgram API key in the worker environment. Generate a key from the Deepgram console:

export DEEPGRAM_API_KEY=<key>

Usage

Import the plugin and pass it to the pipeline’s stt slot.

from zrt.plugins import DeepgramSTT

stt = DeepgramSTT()

# Pipeline(stt=stt, ...)

Parameters

Constructor parameters for the Python SDK (DeepgramSTT). The JavaScript and Go SDKs expose equivalent options where supported, in their idiomatic form (camelCase / STTOptions struct).

Parameter	Type	Default	Description
`api_key`	`str`	`None`	Deepgram API key. Falls back to the `DEEPGRAM_API_KEY` environment variable when unset.
`model`	`str`	`"nova-2"`	Deepgram speech-to-text model.
`language`	`str`	`"en-US"`	Expected language (BCP-47 code) of the caller’s speech.
`interim_results`	`bool`	`True`	Emit partial transcripts while the caller is still speaking.
`punctuate`	`bool`	`True`	Add punctuation to transcripts.
`smart_format`	`bool`	`True`	Apply readable formatting to dates, numbers, and similar entities.
`sample_rate`	`int`	`48000`	Sample rate (Hz) of the input audio.
`endpointing`	`int`	`50`	Milliseconds of silence before an utterance is finalized.
`filler_words`	`bool`	`True`	Keep filler words such as “uh” and “um” in transcripts.
`keywords`	`list[str]`	`None`	Keywords to boost recognition for (legacy keyword boosting).
`keyterm`	`list[str]`	`None`	Key terms to boost (key-term prompting).
`profanity_filter`	`bool`	`False`	Mask profanity in transcripts.
`numerals`	`bool`	`False`	Convert spoken numbers into digits.
`tag`	`str \| list[str]`	`None`	Tags attached to the request for usage tracking.
`enable_diarization`	`bool`	`False`	Label which speaker said each word.
`base_url`	`str`	`"wss://api.deepgram.com/v1/listen"`	Deepgram streaming endpoint.

Import paths

SDK	Import	Constructor
Python	`from zrt.plugins import DeepgramSTT`	`DeepgramSTT()`
JavaScript	`from '@zrt/js-sdk/plugins/deepgram'`	`DeepgramSTT()`
Go	`.../zrt-golang-sdk/plugins/deepgram`	`deepgram.NewSTT(deepgram.STTOptions{})`

Transcribed text passes to the LLM once turn detection decides the caller has finished speaking.

Plugins

Inference Gateway

Speech-to-text

LLM

Text-to-speech

Realtime models

Avatars

Turn detection

Voice activity detection

Noise cancellation

Setup

Usage

Parameters

Import paths

​Setup

​Usage

​Parameters

​Import paths

Setup

Usage

Parameters

Import paths