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

# LiveKit

> Utilisez les modèles vocaux de Gradium dans LiveKit Agents

LiveKit Agents est un framework d'IA vocale en temps réel sur WebRTC, SIP et médias en streaming. Le plugin Gradium permet à un agent LiveKit d'utiliser Gradium pour la transcription (STT), la synthèse vocale (TTS), ou les deux, au sein d'une même `AgentSession`.

<CardGroup cols={2}>
  <Card title="Plugin TTS Gradium" icon="volume-2" href="https://docs.livekit.io/agents/models/tts/gradium/">
    Le guide LiveKit de la synthèse vocale Gradium.
  </Card>

  <Card title="Plugin STT Gradium" icon="mic" href="https://docs.livekit.io/agents/models/stt/gradium/">
    Le guide LiveKit de la transcription Gradium.
  </Card>

  <Card title="Référence du plugin" icon="code" href="https://docs.livekit.io/reference/python/livekit/plugins/gradium/index.html">
    Référence de l'API Python pour `livekit.plugins.gradium`.
  </Card>

  <Card title="Guide Gradium" icon="book" href="https://gradium.ai/content/how-to-build-voice-ai-agent-gradium-livekit">
    Tutoriel complet pour créer un agent vocal avec Gradium et LiveKit.
  </Card>
</CardGroup>

## Installation

Installez LiveKit Agents avec l'extra du plugin Gradium :

```bash theme={null}
pip install "livekit-agents[gradium]~=1.5"
```

Définissez les identifiants requis dans votre environnement :

```bash theme={null}
export LIVEKIT_URL=wss://your-project.livekit.cloud
export LIVEKIT_API_KEY=your-livekit-api-key
export LIVEKIT_API_SECRET=your-livekit-api-secret
export GRADIUM_API_KEY=gd_your_api_key_here
```

## Session d'agent de base

Utilisez `gradium.STT()` pour transcrire l'audio de l'utilisateur et `gradium.TTS()` pour synthétiser les réponses de l'agent.

```python theme={null}
from livekit.agents import AgentSession
from livekit.plugins import gradium

session = AgentSession(
    stt=gradium.STT(language="en"),
    tts=gradium.TTS(
        voice_id="YTpq7expH9539ERJ",
    ),
    # ... llm, vad, tools, and other session options
)
```

Vous pouvez aussi n'utiliser Gradium que d'un côté. Par exemple, conservez un fournisseur STT existant et utilisez Gradium uniquement pour la sortie vocale :

```python theme={null}
session = AgentSession(
    tts=gradium.TTS(),
    # ... llm, stt, etc.
)
```

## Configuration

Options Gradium courantes dans LiveKit Agents :

| Paramètre | S'applique à | Description |
| - | - | - |
| `api_key` | STT, TTS | Clé API Gradium. `GRADIUM_API_KEY` par défaut. |
| `model_endpoint` | STT, TTS | Endpoint WebSocket Gradium. `api.gradium.ai` par défaut ; les requêtes sont automatiquement routées vers le cluster régional le plus proche. |
| `model_name` | STT, TTS | Nom du modèle Gradium. `default` par défaut. |
| `voice_id` | TTS | Identifiant de la voix Gradium utilisée pour les réponses synthétisées. Emma par défaut. |
| `pronunciation_id` | TTS | Identifiant facultatif d'un dictionnaire de prononciation Gradium. |
| `language` | STT | Langue de transcription : `en`, `fr`, `es`, `pt` ou `de`. Définissez-la toujours. |
| `json_config` | TTS | Paramètres TTS avancés, comme la vitesse et les règles de réécriture. |
| `vad_threshold` | STT | Seuil de VAD sémantique pour détecter quand l'utilisateur a fini de parler. |
| `vad_bucket` | STT | Intervalle temporel de la VAD sémantique. |

## Prononciation personnalisée

Passez l'identifiant d'un dictionnaire de prononciation Gradium au plugin TTS lorsqu'un agent doit prononcer de façon cohérente des noms de marque, des noms de produit ou des termes propres à un domaine.

```python theme={null}
tts = gradium.TTS(
    voice_id="YTpq7expH9539ERJ",
    pronunciation_id="pronunciation_dictionary_id",
)
```

Pour un contrôle plus fin de la prononciation et de la réécriture, consultez [Dictionnaires de prononciation](/fr/guides/text-to-speech#dictionnaires-de-prononciation) et [Paramètres de voix](/fr/guides/voice-settings).

## Quand utiliser LiveKit avec Gradium

* **Agents vocaux en temps réel** : exécutez une boucle complète STT, LLM et TTS dans `AgentSession`.
* **Applications WebRTC** : connectez les utilisateurs navigateur et mobiles à la voix propulsée par Gradium via les rooms LiveKit.
* **Agents téléphoniques** : utilisez LiveKit SIP tout en conservant Gradium comme couche de modèles vocaux.
* **Déploiements en production** : déployez des agents LiveKit avec des rooms, des identifiants et des processus workers gérés.


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