--- title: "Gladia | Micdrop" description: "Gladia implementation for @micdrop/server." url: "https://micdrop.dev/docs/ai-integration/provided-integrations/gladia" --- * [Getting Started](/docs/getting-started) * [Client (Browser)](/docs/client) * [Installation](/docs/client/installation) * [React Hooks](/docs/client/react-hooks) * [Start/Stop Call](/docs/client/start-stop-call) * [Pause/Resume Call](/docs/client/pause-resume-call) * [Mute/Unmute Call](/docs/client/mute-unmute-call) * [Call State](/docs/client/call-state) * [Display Conversation Messages](/docs/client/display-conversation-messages) * [Handling Tool Calls](/docs/client/handling-tool-calls) * [Device Management](/docs/client/devices-management) * [Voice Activity Detection (VAD)](/docs/client/vad) * [Error Handling](/docs/client/error-handling) * Utility Classes * [Mic](/docs/client/utility-classes/mic) * [MicdropClient](/docs/client/utility-classes/micdrop-client) * [MicRecorder](/docs/client/utility-classes/mic-recorder) * [Speaker](/docs/client/utility-classes/speaker) * [Server (Node.js)](/docs/server) * [Installation](/docs/server/installation) * [With Fastify](/docs/server/with-fastify) * [With NestJS](/docs/server/with-nestjs) * [Auth and Parameters](/docs/server/auth-and-parameters) * [First Message](/docs/server/first-message) * [Save Messages](/docs/server/save-messages) * [Resume a Conversation](/docs/server/resume-conversation) * [Recording Audio](/docs/server/recording-audio) * [Error Handling](/docs/server/error-handling) * [Tools](/docs/server/tools) * [Extract Value from Answer](/docs/server/extract) * [Auto End Call](/docs/server/auto-end-call) * [Semantic Turn Detection](/docs/server/semantic-turn-detection) * [Noise Filtering](/docs/server/noise-filtering) * [Micdrop Protocol](/docs/server/protocol) * [AI Integrations](/docs/ai-integration) * Provided Integrations * [AI SDK](/docs/ai-integration/provided-integrations/ai-sdk) * [Cartesia](/docs/ai-integration/provided-integrations/cartesia) * [ElevenLabs](/docs/ai-integration/provided-integrations/elevenlabs) * [Gladia](/docs/ai-integration/provided-integrations/gladia) * [Gradium](/docs/ai-integration/provided-integrations/gradium) * [Mistral](/docs/ai-integration/provided-integrations/mistral) * [OpenAI](/docs/ai-integration/provided-integrations/openai) * Custom Integrations * [Agent (LLM)](/docs/ai-integration/custom-integrations/custom-agent) * [Speech-to-Text (STT)](/docs/ai-integration/custom-integrations/custom-stt) * [Text-to-Speech (TTS)](/docs/ai-integration/custom-integrations/custom-tts) * Fallback Strategies * [FallbackAgent](/docs/ai-integration/fallback-strategies/agent-fallback) * [FallbackSTT](/docs/ai-integration/fallback-strategies/stt-fallback) * [FallbackTTS](/docs/ai-integration/fallback-strategies/tts-fallback) * [IA Vocale Souveraine 🇫🇷🇪🇺](/docs/ai-integration/sovereign-voice-ai) [Micdrop](/) › [Documentation](/docs/getting-started) # Gladia Gladia implementation for [@micdrop/server](/docs/server). This package provides high-quality real-time speech-to-text implementation using Gladia’s streaming API. ## Installation Terminal window ``` npm install @micdrop/gladia ``` ## Usage ``` import { GladiaSTT } from '@micdrop/gladia'import { MicdropServer } from '@micdrop/server' const stt = new GladiaSTT({ apiKey: process.env.GLADIA_API_KEY || '',}) // Use with MicdropServernew MicdropServer(socket, { stt, // ... other options}) ``` ## Options Option Type Default Description `apiKey` `string` Required Your Gladia API key `settings` `DeepPartial` Optional Advanced configuration for Gladia live session `connectionTimeout` `number` `5000` Timeout in milliseconds for WebSocket connection `transcriptionTimeout` `number` `4000` Timeout in milliseconds to wait for transcription `retryDelay` `number` `1000` Delay in milliseconds between reconnection attempts `maxRetry` `number` `3` Maximum number of reconnection attempts before failing ## Configuration Settings The `settings` option allows you to customize various aspects of the transcription: ### Language Configuration ``` const stt = new GladiaSTT({ apiKey: 'your-api-key', settings: { language_config: { languages: ['en', 'fr', 'es'], // Specify target languages code_switching: true, // Enable automatic language switching }, },}) ``` ### Pre-processing Options ``` const stt = new GladiaSTT({ apiKey: 'your-api-key', settings: { pre_processing: { audio_enhancer: true, // Enhance audio quality speech_threshold: 0.7, // Adjust speech detection sensitivity (0.0-1.0) }, },}) ``` ### Real-time Processing Features ``` const stt = new GladiaSTT({ apiKey: 'your-api-key', settings: { realtime_processing: { words_accurate_timestamps: true, // Get word-level timestamps translation: true, // Enable translation translation_config: { target_languages: ['fr', 'es'], // Translate to French and Spanish model: 'enhanced', // Use enhanced translation model }, named_entity_recognition: true, // Extract entities (names, places, etc.) sentiment_analysis: true, // Analyze sentiment custom_vocabulary: true, // Use custom vocabulary custom_vocabulary_config: { vocabulary: ['Micdrop', { value: 'API', pronunciations: ['A-P-I'] }], default_intensity: 1, }, }, },}) ``` ## Supported Languages Gladia supports 90+ languages with automatic detection. Some of the most commonly used languages include: Code Language Code Language Code Language `en` English `es` Spanish `fr` French `de` German `it` Italian `pt` Portuguese `ru` Russian `ja` Japanese `ko` Korean `zh` Chinese `ar` Arabic `hi` Hindi `nl` Dutch `pl` Polish `tr` Turkish `sv` Swedish `da` Danish `no` Norwegian `fi` Finnish `cs` Czech `hu` Hungarian `el` Greek `he` Hebrew `th` Thai `vi` Vietnamese `id` Indonesian `ms` Malay See the [types file](https://github.com/Godefroy/micdrop/blob/main/packages/gladia/src/types.ts) for the complete list of supported language codes. ## Advanced Features ### Custom Vocabulary Improve transcription accuracy for domain-specific terms: ``` const stt = new GladiaSTT({ apiKey: 'your-api-key', settings: { realtime_processing: { custom_vocabulary: true, custom_vocabulary_config: { vocabulary: [ 'Micdrop', 'WebSocket', { value: 'OAuth', pronunciations: ['O-Auth', 'oh-auth'], intensity: 2, language: 'en', }, ], default_intensity: 1, }, }, },}) ``` ### Translation Real-time translation during transcription: ``` const stt = new GladiaSTT({ apiKey: 'your-api-key', settings: { realtime_processing: { translation: true, translation_config: { target_languages: ['fr', 'es', 'de'], model: 'enhanced', // 'base' or 'enhanced' match_original_utterances: true, context_adaptation: true, context: 'Technical software development discussion', }, }, },}) ``` [Previous← ElevenLabs](/docs/ai-integration/provided-integrations/elevenlabs)[NextGradium →](/docs/ai-integration/provided-integrations/gradium) On this page * [Installation](#installation) * [Usage](#usage) * [Options](#options) * [Configuration Settings](#configuration-settings) * [Language Configuration](#language-configuration) * [Pre-processing Options](#pre-processing-options) * [Real-time Processing Features](#real-time-processing-features) * [Supported Languages](#supported-languages) * [Advanced Features](#advanced-features) * [Custom Vocabulary](#custom-vocabulary) * [Translation](#translation)