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

# Cloudflare

Mastra 的 CloudflareVoice 類別透過 Cloudflare Workers AI 提供文字轉語音功能。此 Provider 專注於高效率、低延遲的語音合成，適合邊緣運算環境。

## 使用範例

```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 使用的模型名稱。

**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 針對低延遲的邊緣運算進行最佳化
- 此 Provider 僅支援文字轉語音（TTS）功能，不支援語音轉文字（STT）
- 此服務能與其他 Cloudflare Workers 產品良好整合
- 在正式環境使用時，請確認您的 Cloudflare 帳戶具備適當的 Workers AI 訂閱方案
- 相較於其他部分 Provider，可選語音較少，但邊緣效能極佳

## 相關 Provider

如果除了文字轉語音之外也需要語音轉文字功能，請考慮使用下列 Provider：

- [OpenAI](https://mastra.zisheng.pro/zh-TW/reference/voice/openai)：同時提供 TTS 與 STT
- [Google](https://mastra.zisheng.pro/zh-TW/reference/voice/google)：同時提供 TTS 與 STT
- [Azure](https://mastra.zisheng.pro/zh-TW/reference/voice/azure)：同時提供 TTS 與 STT