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

# Cloudflare

Mastra の CloudflareVoice クラスは、Cloudflare Workers AI を使用した Text-to-Speech 機能を提供します。この 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`): Text-to-Speech 合成の設定。

**speechModel.name** (`string`): TTS に使用するモデル名。

**speechModel.apiKey** (`string`): Workers AI へのアクセス権を持つ Cloudflare API トークン。未指定の場合は CLOUDFLARE\_API\_TOKEN 環境変数を使用します。

**speechModel.accountId** (`string`): Cloudflare アカウント ID。未指定の場合は CLOUDFLARE\_ACCOUNT\_ID 環境変数を使用します。

**speaker** (`string`): 音声合成に使用するデフォルトの Voice ID。 (Default: `'en-US-1'`)

## メソッド

### `speak()`

Cloudflare の Text-to-Speech サービスを使用してテキストを音声に変換します。

**input** (`string | NodeJS.ReadableStream`): 音声に変換するテキストまたはテキストストリーム。

**options** (`Options`): 設定オプション。

**options.speaker** (`string`): 音声合成に使用する Voice ID。

**options.format** (`string`): 出力音声形式。

戻り値：`Promise<NodeJS.ReadableStream>`

### `getSpeakers()`

使用可能な Voice オプションの配列を返します。各要素には次の値が含まれます。

**voiceId** (`string`): Voice の一意な識別子（例：'en-US-1'）

**language** (`string`): Voice の言語コード（例：'en-US'）

## 注意事項

- API トークンは、コンストラクターオプションまたは環境変数（CLOUDFLARE\_API\_TOKEN と CLOUDFLARE\_ACCOUNT\_ID）で指定できます
- Cloudflare Workers AI は、低レイテンシーのエッジコンピューティング向けに最適化されています
- この Provider は Text-to-Speech（TTS）機能だけをサポートし、Speech-to-Text（STT）はサポートしません
- このサービスは、ほかの Cloudflare Workers 製品と適切に統合できます
- 本番環境で使用する場合は、Cloudflare アカウントに適切な Workers AI サブスクリプションがあることを確認してください
- 一部の Provider と比べると Voice オプションは限定的ですが、エッジで優れたパフォーマンスを発揮します

## 関連 Provider

Text-to-Speech に加えて Speech-to-Text 機能も必要な場合は、次の Provider の使用を検討してください。

- [OpenAI](https://mastra.zisheng.pro/ja/reference/voice/openai)：TTS と STT の両方を提供します
- [Google](https://mastra.zisheng.pro/ja/reference/voice/google)：TTS と STT の両方を提供します
- [Azure](https://mastra.zisheng.pro/ja/reference/voice/azure)：TTS と STT の両方を提供します