Gladia

OverviewCopy Anchor Link

GladiaSTTService opens a Gladia live session over HTTP (POST /v2/live), then streams base64 audio over the returned WebSocket, with code-switching, translation, custom vocabulary and realtime processing options (see @pipedog/gladia/config).

InstallationCopy Anchor Link

bun add @pipedog/gladia

PrerequisitesCopy Anchor Link

• A Gladia account and API key, passed as apiKey (the examples read GLADIA_API_KEY).

GladiaSTTServiceCopy Anchor Link

ConfigurationCopy Anchor Link

SettingsCopy Anchor Link

Runtime-updatable settings, passed as settings: new GladiaSTTService.Settings({...}). Settings you leave out keep their defaults.

UsageCopy Anchor Link

import { LanguageConfig } from "@pipedog/gladia/config";
import { GladiaSTTService } from "@pipedog/gladia/stt";

const stt = new GladiaSTTService({
  apiKey: process.env.GLADIA_API_KEY ?? "",
  region: "eu-west",
  settings: new GladiaSTTService.Settings({
    languageConfig: new LanguageConfig({ languages: ["en", "fr"], codeSwitching: true }),
  }),
});

NotesCopy Anchor Link

• region is "us-west" or "eu-west". Pass fetch to customize the session request.

RuntimesCopy Anchor Link

Generated from pipecat.runtimes and pipecat.compat in packages/gladia/package.json: ✅ means the compat smoke test passes on that runtime.

The service uses fetch and the global WebSocket (through core's websocketConnect, which sends the auth header on the handshake on Cloudflare Workers too). Pass no SDK; nothing is Node-only.