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

# Cloudflare

La classe CloudflareVoice de Mastra fournit des fonctionnalités de synthèse vocale au moyen de Cloudflare Workers AI. Ce Provider est spécialisé dans la synthèse vocale efficace et à faible latence, adaptée aux environnements d'informatique en périphérie.

## Exemple d'utilisation

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

## Configuration

### Options du constructeur

**speechModel** (`CloudflareSpeechConfig`): Configuration de la synthèse vocale.

**speechModel.name** (`string`): Nom du modèle à utiliser pour la synthèse vocale.

**speechModel.apiKey** (`string`): Token d'API Cloudflare doté d'un accès à Workers AI. Utilise par défaut la variable d'environnement CLOUDFLARE\_API\_TOKEN.

**speechModel.accountId** (`string`): Identifiant du compte Cloudflare. Utilise par défaut la variable d'environnement CLOUDFLARE\_ACCOUNT\_ID.

**speaker** (`string`): Identifiant vocal par défaut pour la synthèse vocale. (Default: `'en-US-1'`)

## Méthodes

### `speak()`

Convertit du texte en parole au moyen du service de synthèse vocale de Cloudflare.

**input** (`string | NodeJS.ReadableStream`): Texte ou flux de texte à convertir en parole.

**options** (`Options`): Options de configuration.

**options.speaker** (`string`): Identifiant vocal à utiliser pour la synthèse vocale.

**options.format** (`string`): Format audio de sortie.

Renvoie : `Promise<NodeJS.ReadableStream>`

### `getSpeakers()`

Renvoie un tableau des options vocales disponibles, dans lequel chaque élément contient :

**voiceId** (`string`): Identifiant unique de la voix (par exemple, 'en-US-1')

**language** (`string`): Code de langue de la voix (par exemple, 'en-US')

## Remarques

- Les tokens d'API peuvent être fournis au moyen des options du constructeur ou des variables d'environnement (CLOUDFLARE\_API\_TOKEN et CLOUDFLARE\_ACCOUNT\_ID)
- Cloudflare Workers AI est optimisé pour l'informatique en périphérie à faible latence
- Ce Provider prend uniquement en charge la synthèse vocale (TTS), et non la reconnaissance vocale (STT)
- Le service s'intègre parfaitement aux autres produits Cloudflare Workers
- Pour une utilisation en production, assurez-vous que votre compte Cloudflare dispose de l'abonnement Workers AI approprié
- Les options vocales sont plus limitées que chez certains autres Providers, mais les performances en périphérie sont excellentes

## Providers associés

Si vous avez besoin de fonctionnalités de reconnaissance vocale en plus de la synthèse vocale, envisagez d'utiliser l'un des Providers suivants :

- [OpenAI](https://mastra.zisheng.pro/fr/reference/voice/openai) : fournit à la fois la TTS et la STT
- [Google](https://mastra.zisheng.pro/fr/reference/voice/google) : fournit à la fois la TTS et la STT
- [Azure](https://mastra.zisheng.pro/fr/reference/voice/azure) : fournit à la fois la TTS et la STT