> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gradium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipecat

> Utiliser la synthèse vocale en streaming de Gradium dans les agents vocaux Pipecat

Pipecat est un framework de création d'agents vocaux et multimodaux en temps réel. Son `GradiumTTSService` permet à un pipeline Pipecat de diffuser en flux de la parole synthétisée via l'API WebSocket de Gradium.

<CardGroup cols={2}>
  <Card title="Référence Gradium de Pipecat" icon="code" href="https://reference-server.pipecat.ai/en/latest/api/pipecat.services.gradium.tts.html">
    Référence d'API de `GradiumTTSService`.
  </Card>

  <Card title="Exemple vocal Gradium" icon="play" href="https://github.com/pipecat-ai/pipecat/blob/main/examples/voice/voice-gradium.py">
    Exemple Pipecat complet utilisant les services Gradium.
  </Card>

  <Card title="Gradient Bang" icon="github" href="https://github.com/pipecat-ai/gradient-bang">
    Le jeu multijoueur de Pipecat, qui utilise Gradium pour la synthèse vocale par défaut.
  </Card>

  <Card title="Guide TTS Gradium" icon="book" href="/fr/guides/text-to-speech">
    Configuration de la synthèse vocale Gradium via WebSocket et comportement du streaming.
  </Card>
</CardGroup>

## Installation

Installez Pipecat avec l'extra Gradium :

```bash theme={null}
uv add "pipecat-ai[gradium]"
```

Définissez votre clé API Gradium dans l'environnement :

```bash theme={null}
export GRADIUM_API_KEY=gd_your_api_key_here
```

## Configuration de base

Créez un `GradiumTTSService` avec votre clé API et un ID de voix Gradium. Avec Pipecat, l'usage actuel consiste à passer les options d'exécution via `GradiumTTSService.Settings(...)`.

```python theme={null}
import os

from pipecat.services.gradium.tts import GradiumTTSService

tts = GradiumTTSService(
    api_key=os.environ["GRADIUM_API_KEY"],
    settings=GradiumTTSService.Settings(
        voice="YTpq7expH9539ERJ",
    ),
)
```

Placez ensuite le service dans le pipeline audio, après le LLM et avant la sortie du transport :

```python theme={null}
pipeline = Pipeline(
    [
        transport.input(),
        stt,
        user_aggregator,
        llm,
        tts,
        transport.output(),
        assistant_aggregator,
    ]
)
```

## Configuration

Paramètres courants :

| Paramètre | Type | Description |
| - | - | - |
| `api_key` | `str` | Clé API Gradium. |
| `settings.voice` | `str` | ID de la voix Gradium utilisée pour la synthèse. |
| `settings.model` | `str` | Nom de modèle Gradium, facultatif. |
| `settings.language` | `Language \| str` | Langue de synthèse, facultative. |
| `url` | `str` | Remplacement facultatif de l'endpoint WebSocket Gradium. |
| `json_config` | `str` | Chaîne JSON facultative pour une configuration supplémentaire du modèle. |

<Note>
  Dans Pipecat, la synthèse vocale Gradium produit de l'audio à 48kHz. Pipecat définit automatiquement cette fréquence d'échantillonnage.
</Note>

## Comportement à l'exécution

* **Audio en streaming** : Gradium émet l'audio via un WebSocket, que Pipecat relaie à travers le transport actif.
* **Horodatage des mots** : les événements d'horodatage de Gradium permettent d'afficher du texte synchronisé.
* **Changement de voix** : modifier le paramètre `voice` à l'exécution reconnecte le WebSocket Gradium avec la nouvelle voix.
* **Événements de connexion** : `on_connected`, `on_disconnected` et `on_connection_error` sont disponibles pour la journalisation et les contrôles de santé.

```python theme={null}
@tts.event_handler("on_connected")
async def on_connected(service):
    print("Connected to Gradium")
```

## Projet d'exemple

[Gradient Bang](https://github.com/pipecat-ai/gradient-bang) est le jeu multijoueur de Pipecat ; il utilise Gradium comme fournisseur de synthèse vocale par défaut. Son environnement de bot inclut `TTS_PROVIDER=gradium`, ce qui en fait une référence plus complète et utile pour une véritable application d'agent vocal construite sur Pipecat.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.