stt

Groq speech-to-text service implementation using Whisper models.

class pipecat.services.groq.stt.GroqSTTSettings(model: str | None | _NotGiven = <factory>, extra: dict[str, Any]=<factory>, language: Language | str | None | _NotGiven = <factory>, prompt: str | None | _NotGiven = <factory>, temperature: float | None | _NotGiven = <factory>)[source]

Bases: BaseWhisperSTTSettings

Settings for the Groq STT service.

Parameters:

prompt – Optional prompt text to guide transcription style.

class pipecat.services.groq.stt.GroqSTTService(*, model: str | None = None, api_key: str | None = None, base_url: str = 'https://api.groq.com/openai/v1', language: Language | None = None, prompt: str | None = None, temperature: float | None = None, settings: GroqSTTSettings | None = None, ttfs_p99_latency: float | None = 1.54, **kwargs)[source]

Bases: BaseWhisperSTTService

Groq Whisper speech-to-text service.

Uses Groq’s Whisper API to convert audio to text. Requires a Groq API key set via the api_key parameter or GROQ_API_KEY environment variable.

Settings

alias of GroqSTTSettings

__init__(*, model: str | None = None, api_key: str | None = None, base_url: str = 'https://api.groq.com/openai/v1', language: Language | None = None, prompt: str | None = None, temperature: float | None = None, settings: GroqSTTSettings | None = None, ttfs_p99_latency: float | None = 1.54, **kwargs)[source]

Initialize Groq STT service.

Parameters:

  • model –

    Whisper model to use.

    Deprecated since version 0.0.105: Use settings=GroqSTTService.Settings(model=...) instead.

  • api_key – Groq API key. Defaults to None.

  • base_url – API base URL. Defaults to “https://api.groq.com/openai/v1”.

  • language –

    Language of the audio input.

    Deprecated since version 0.0.105: Use settings=GroqSTTService.Settings(language=...) instead.

  • prompt –

    Optional text to guide the model’s style or continue a previous segment.

    Deprecated since version 0.0.105: Use settings=GroqSTTService.Settings(prompt=...) instead.

  • temperature –

    Optional sampling temperature between 0 and 1.

    Deprecated since version 0.0.105: Use settings=GroqSTTService.Settings(temperature=...) instead.

  • settings – Runtime-updatable settings. When provided alongside deprecated parameters, settings values take precedence.

  • ttfs_p99_latency – P99 latency from speech end to final transcript in seconds. Override for your deployment. See https://github.com/pipecat-ai/stt-benchmark

  • **kwargs – Additional arguments passed to BaseWhisperSTTService.