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

# 딥그램

Mastra의 Deepgram 음성 구현은 Deepgram의 API를 사용하여 텍스트 음성 변환(TTS) 및 음성 텍스트 변환(STT) 기능을 제공합니다. 음성 합성 및 전사에 대한 구성 가능한 옵션을 통해 여러 음성 Model 및 언어를 지원합니다.

## 사용예

```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)
```

## 생성자 매개변수

**speechModel** (`DeepgramVoiceConfig`): 텍스트 음성 변환 기능을 위한 구성입니다. (Default: `{ name: 'aura' }`)

**speechModel.name** (`DeepgramModel`): 사용할 Deepgram Model

**speechModel.apiKey** (`string`): Deepgram API 키입니다. 없으면 DEEPGRAM\_API\_KEY 환경 변수를 사용합니다.

**speechModel.properties** (`Record<string, any>`): Deepgram API에 전달할 추가 속성

**speechModel.language** (`string`): Model의 언어 코드

**listeningModel** (`DeepgramVoiceConfig`): 음성 텍스트 변환 기능을 위한 구성입니다. (Default: `{ name: 'nova' }`)

**listeningModel.name** (`DeepgramModel`): 사용할 Deepgram Model

**listeningModel.apiKey** (`string`): Deepgram API 키입니다. 없으면 DEEPGRAM\_API\_KEY 환경 변수를 사용합니다.

**listeningModel.properties** (`Record<string, any>`): Deepgram API에 전달할 추가 속성

**listeningModel.language** (`string`): Model의 언어 코드

**speaker** (`DeepgramVoiceId`): 텍스트 음성 변환에 사용할 기본 음성 (Default: `'asteria-en'`)

## 행동 양식

### `speak()`

구성된 음성 Model 및 음성을 사용하여 텍스트를 음성으로 변환합니다.

**input** (`string | NodeJS.ReadableStream`): 음성으로 변환할 텍스트입니다. 스트림을 제공하면 먼저 텍스트로 변환합니다.

**options** (`object`): 음성 합성을 위한 추가 옵션

**options.speaker** (`string`): 이 요청에 사용할 화자를 기본값 대신 지정합니다.

보고:`Promise<NodeJS.ReadableStream>`

### `listen()`

구성된 청취 Model을 사용하여 음성을 텍스트로 변환합니다.

**audioStream** (`NodeJS.ReadableStream`): 전사할 오디오 스트림

**options** (`object`): Deepgram API에 전달할 추가 옵션

보고:`Promise<string>`

### `getSpeakers()`

사용 가능한 음성 옵션 목록을 반환합니다.

**voiceId** (`string`): 음성의 고유 식별자