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

# 클라우드플레어

Mastra의 CloudflareVoice 클래스는 Cloudflare Workers AI를 사용하여 텍스트 음성 변환 기능을 제공합니다. 이 공급자는 엣지 컴퓨팅 환경에 적합한 효율적이고 지연 시간이 짧은 음성 합성을 전문으로 합니다.

## 사용예

```typescript
import { CloudflareVoice } from '@mastra/voice-cloudflare'

// Initialize with configuration
const voice = new CloudflareVoice({
  speechModel: {
    name: '@cf/meta/m2m100-1.2b',
    apiKey: 'your-cloudflare-api-token',
    accountId: 'your-cloudflare-account-id',
  },
  speaker: 'en-US-1', // Default voice
})

// Convert text to speech
const audioStream = await voice.speak('Hello, how can I help you?', {
  speaker: 'en-US-2', // Override default voice
})

// Get available voices
const speakers = await voice.getSpeakers()
console.log(speakers)
```

## 구성

### 생성자 옵션

**speechModel** (`CloudflareSpeechConfig`): 텍스트 음성 변환 합성을 위한 구성입니다.

**speechModel.name** (`string`): TTS에 사용할 Model 이름입니다.

**speechModel.apiKey** (`string`): Workers AI 액세스 권한이 있는 Cloudflare API 토큰입니다. 없으면 CLOUDFLARE\_API\_TOKEN 환경 변수를 사용합니다.

**speechModel.accountId** (`string`): Cloudflare 계정 ID입니다. 없으면 CLOUDFLARE\_ACCOUNT\_ID 환경 변수를 사용합니다.

**speaker** (`string`): 음성 합성에 사용할 기본 음성 ID입니다. (Default: `'en-US-1'`)

## 행동 양식

### `speak()`

Cloudflare의 텍스트 음성 변환 서비스를 사용하여 텍스트를 음성으로 변환합니다.

**input** (`string | NodeJS.ReadableStream`): 음성으로 변환할 텍스트 또는 텍스트 스트림입니다.

**options** (`Options`): 구성 옵션입니다.

**options.speaker** (`string`): 음성 합성에 사용할 음성 ID입니다.

**options.format** (`string`): 출력 오디오 형식입니다.

보고:`Promise<NodeJS.ReadableStream>`

### `getSpeakers()`

각 노드에 다음이 포함된 사용 가능한 음성 옵션의 배열을 반환합니다.

**voiceId** (`string`): 음성의 고유 식별자(예: 'en-US-1')

**language** (`string`): 음성의 언어 코드(예: 'en-US')

## 메모

- API 토큰은 생성자 옵션 또는 환경 변수(CLOUDFLARE\_API\_TOKEN 및 CLOUDFLARE\_ACCOUNT\_ID)를 통해 제공될 수 있습니다.
- Cloudflare Workers AI는 대기 시간이 짧은 엣지 컴퓨팅에 최적화되어 있습니다.
- 이 공급자는 STT(음성-텍스트)가 아닌 TTS(텍스트 음성 변환) 기능만 지원합니다.
- 이 서비스는 다른 Cloudflare Workers 제품과 잘 통합됩니다.
- 프로덕션 용도로 사용하려면 Cloudflare 계정에 적절한 Workers AI 구독이 있는지 확인하세요.
- 다른 Provider에 비해 음성 옵션이 더 제한적이지만 엣지에서의 성능은 뛰어납니다.

## 관련 공급자

텍스트 음성 변환 외에 음성 텍스트 변환 기능이 필요한 경우 다음 공급자 중 하나를 사용하는 것이 좋습니다.

- [오픈AI](https://mastra.zisheng.pro/ko/reference/voice/openai): TTS, STT 모두 제공
- [Google](https://mastra.zisheng.pro/ko/reference/voice/google): TTS, STT 모두 제공
- [하늘빛](https://mastra.zisheng.pro/ko/reference/voice/azure): TTS, STT 모두 제공