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.

Référence Gradium de Pipecat

Référence d’API de GradiumTTSService.

Exemple vocal Gradium

Exemple Pipecat complet utilisant les services Gradium.

Gradient Bang

Le jeu multijoueur de Pipecat, qui utilise Gradium pour la synthèse vocale par défaut.

Guide TTS Gradium

Configuration de la synthèse vocale Gradium via WebSocket et comportement du streaming.

Installation

Installez Pipecat avec l’extra Gradium :

uv add "pipecat-ai[gradium]"

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

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(...).

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 :

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.

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

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é.

@tts.event_handler("on_connected")
async def on_connected(service):
    print("Connected to Gradium")

Projet d’exemple

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.

Introduction

Frameworks d'agents

Outils

Référence Gradium de Pipecat

Exemple vocal Gradium

Gradient Bang

Guide TTS Gradium

Installation

Configuration de base

Configuration

Comportement à l’exécution

Projet d’exemple

Référence Gradium de Pipecat

Exemple vocal Gradium

Gradient Bang

Guide TTS Gradium

​Installation

​Configuration de base

​Configuration

​Comportement à l’exécution

​Projet d’exemple

Installation

Configuration de base

Configuration

Comportement à l’exécution

Projet d’exemple