deepgram-sdk-patterns

# Deepgram SDK Patterns ## Overview Production patterns for `@deepgram/sdk` (TypeScript) and `deepgram-sdk` (Python). Covers singleton client, typed wrappers, text-to-speech with Aura, audio intelligence pipeline, error handling, and SDK v5 migration path. ## Prerequisites - `npm install @deepgram/sdk` or `pip install deepgram-sdk` - `DEEPGRAM_API_KEY` environment variable configured ## Instructions ### Step 1: Singleton Client (TypeScript) ```typescript import { createClient, DeepgramClient } from '@deepgram/sdk'; class DeepgramService { private static instance: DeepgramService; private client: DeepgramClient; private constructor() { const apiKey = process.env.DEEPGRAM_API_KEY; if (!apiKey) throw new Error('DEEPGRAM_API_KEY is required'); this.client = createClient(apiKey); } static getInstance(): DeepgramService { if (!this.instance) this.instance = new DeepgramService(); return this.instance; } getClient(): DeepgramClient { return this.client; } } export const deepgram = DeepgramService.getInstance().getClient(); ``` ### Step 2: Text-to-Speech with Aura ```typescript import { createClient } from '@deepgram/sdk'; import { writeFileSync } from 'fs'; const deepgram = createClient(process.env.DEEPGRAM_API_KEY!); async function textToSpeech(text: string, outputPath: string) { const response = await deepgram.speak.request( { text }, { model: 'aura-2-thalia-en', // Female English voice encoding: 'linear16', ...