Gladia

​

Overview

GladiaSTTService is a speech-to-text (STT) service that integrates with Gladia’s API to provide real-time transcription capabilities. It processes audio input and produces transcription frames in real-time.

​

Installation

To use GladiaSTTService, you need to install the Gladia dependencies:

pip install pipecat-ai[gladia]

You’ll also need to set up your Gladia API key as an environment variable: GLADIA_API_KEY

​

Configuration

​

Service Parameters

​

Audio Processing Parameters

​

Input Requirements

The service processes InputAudioRawFrame instances with:

• Raw PCM audio data
• 16-bit depth
• Sample rate matching configuration (default 16kHz)
• Single channel (mono)

See Audio Frames for detailed frame structure.

​

Output

The service produces two types of frames during transcription:

​

InterimTranscriptionFrame

Generated during ongoing speech when confidence threshold is met. Contains:

​

TranscriptionFrame

Generated for final transcriptions when confidence threshold is met. Contains identical fields to InterimTranscriptionFrame but represents confirmed text.

See Text Frames for detailed frame structures.

​

Example Usage

from pipecat.services.gladia import GladiaSTTService
from pipecat.transcriptions.language import Language

# Configure the service
stt_service = GladiaSTTService(
    api_key="your-api-key",
    confidence=0.7,
    params=GladiaSTTService.InputParams(
        language=Language.EN,
        audio_enhancer=True,
        sample_rate=16000
    )
)

# Use in a pipeline
pipeline = Pipeline([
    transport.input(),    # Produces InputAudioRawFrame
    stt_service,          # Processes audio → produces transcription frames
    llm_processor,        # Consumes TranscriptionFrame
])

​

Methods

See the STT base class methods for additional functionality.

​

Language Setting

await service.set_language(Language.FR)

​

Language Support

Gladia STT supports the following languages:

​

Usage Example

# Configure service with specific language
stt_service = GladiaSTTService(
    api_key="your-api-key",
    params=GladiaSTTService.InputParams(
        language=Language.FR  # French
    )
)

Note: Gladia uses simplified language codes without regional variants.

​

Frame Flow

​

Service Control

The service accepts STTUpdateSettingsFrame for dynamic configuration updates. See Service Control Frames for details.

​

Notes

• Audio input must be in PCM format
• Transcription frames are only generated when confidence threshold is met
• Language detection is optional
• Service automatically handles websocket connections and cleanup
• Real-time processing occurs in parallel for natural conversation flow