> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Deepgram

L'implémentation vocale Deepgram de Mastra fournit des fonctionnalités de synthèse vocale (TTS) et de reconnaissance vocale (STT) au moyen de l'API Deepgram. Elle prend en charge plusieurs modèles vocaux et plusieurs langues, avec des options configurables pour la synthèse vocale et la transcription.

## Exemple d'utilisation

```typescript
import { DeepgramVoice } from '@mastra/voice-deepgram'

// Initialize with default configuration (uses DEEPGRAM_API_KEY environment variable)
const voice = new DeepgramVoice()

// Initialize with custom configuration
const voice = new DeepgramVoice({
  speechModel: {
    name: 'aura',
    apiKey: 'your-api-key',
  },
  listeningModel: {
    name: 'nova-2',
    apiKey: 'your-api-key',
  },
  speaker: 'asteria-en',
})

// Text-to-Speech
const audioStream = await voice.speak('Hello, world!')

// Speech-to-Text
const transcript = await voice.listen(audioStream)
```

## Paramètres du constructeur

**speechModel** (`DeepgramVoiceConfig`): Configuration de la fonctionnalité de synthèse vocale. (Default: `{ name: 'aura' }`)

**speechModel.name** (`DeepgramModel`): Modèle Deepgram à utiliser

**speechModel.apiKey** (`string`): Clé d'API Deepgram. Utilise par défaut la variable d'environnement DEEPGRAM\_API\_KEY

**speechModel.properties** (`Record<string, any>`): Propriétés supplémentaires à transmettre à l'API Deepgram

**speechModel.language** (`string`): Code de langue du modèle

**listeningModel** (`DeepgramVoiceConfig`): Configuration de la fonctionnalité de reconnaissance vocale. (Default: `{ name: 'nova' }`)

**listeningModel.name** (`DeepgramModel`): Modèle Deepgram à utiliser

**listeningModel.apiKey** (`string`): Clé d'API Deepgram. Utilise par défaut la variable d'environnement DEEPGRAM\_API\_KEY

**listeningModel.properties** (`Record<string, any>`): Propriétés supplémentaires à transmettre à l'API Deepgram

**listeningModel.language** (`string`): Code de langue du modèle

**speaker** (`DeepgramVoiceId`): Voix à utiliser par défaut pour la synthèse vocale (Default: `'asteria-en'`)

## Méthodes

### `speak()`

Convertit du texte en parole au moyen du modèle vocal et de la voix configurés.

**input** (`string | NodeJS.ReadableStream`): Texte à convertir en parole. Si un flux est fourni, il est d'abord converti en texte.

**options** (`object`): Options supplémentaires pour la synthèse vocale

**options.speaker** (`string`): Remplace la voix par défaut pour cette requête

Renvoie : `Promise<NodeJS.ReadableStream>`

### `listen()`

Convertit la parole en texte au moyen du modèle de reconnaissance configuré.

**audioStream** (`NodeJS.ReadableStream`): Flux audio à transcrire

**options** (`object`): Options supplémentaires à transmettre à l'API Deepgram

Renvoie : `Promise<string>`

### `getSpeakers()`

Renvoie la liste des options vocales disponibles.

**voiceId** (`string`): Identifiant unique de la voix