> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# LiveAvatar

## Présentation

L'intégration LiveAvatar connecte ElevenAgents à la plateforme [LiveAvatar](https://docs.liveavatar.com) de HeyGen afin de créer des expériences interactives avec des avatars. Elle associe ElevenLabs Agents, qui gère les interactions audio, au streaming vidéo d'avatars en temps réel de LiveAvatar, pour permettre des conversations visuelles à faible latence avec des avatars IA.

Cette intégration vous permet de :

* Déployer des agents d'IA conversationnelle avec une représentation visuelle sous forme d'avatar
* Créer des expériences de service client interactives avec des avatars réalistes
* Concevoir des assistants virtuels engageants pour des sites web et des applications

## Fonctionnement

L'intégration utilise le mode de session LITE de LiveAvatar, dans lequel les responsabilités sont réparties entre les deux plateformes :

* **ElevenLabs** : gère le streaming et l'orchestration des entrées et sorties audio
* **LiveAvatar** : gère le rendu des avatars et le streaming vidéo en temps réel

Lorsqu'une session en mode LITE démarre avec une configuration ElevenAgents, LiveAvatar lance un worker qui se connecte à votre agent ElevenLabs. La sortie audio de l'agent pilote en temps réel la synchronisation labiale et les animations de l'avatar.

```mermaid
sequenceDiagram
    participant User
    participant LiveAvatar
    participant ElevenLabs Agent

    User->>LiveAvatar: Start LITE session with agent config
    LiveAvatar->>ElevenLabs Agent: Connect worker to agent
    User->>ElevenLabs Agent: Audio input (speech)
    ElevenLabs Agent->>ElevenLabs Agent: Audio orchestration + LLM
    ElevenLabs Agent->>LiveAvatar: Audio output
    LiveAvatar->>User: Avatar video stream with lip sync
```

## Prérequis

Avant de configurer l'intégration, assurez-vous de disposer des éléments suivants :

1. Un compte ElevenLabs avec accès à l'API
2. Un compte HeyGen LiveAvatar avec accès à l'API
3. Un agent ElevenLabs, créé en suivant le [guide de démarrage rapide](/docs/fr/eleven-agents/quickstart)

> **Note**
>
> L'agent ElevenLabs doit avoir ses formats d'entrée et de sortie audio configurés sur PCM 24000 Hz. Vous pouvez les
> définir dans les paramètres Voice > Formats de sortie TTS, et Advanced > Format audio d'entrée utilisateur.

## Configuration

#### Obtenez vos identifiants ElevenLabs

Vous avez besoin de deux éléments de votre compte ElevenLabs :

1. **ID de l'agent** : accédez à [Agents Platform > Agents](https://elevenlabs.io/app/agents/agents) et copiez l'ID de l'agent que vous souhaitez utiliser

2. **Clé API** : accédez à [Settings > API Keys](https://elevenlabs.io/app/settings/api-keys) et générez une nouvelle clé API, ou utilisez-en une existante

> **Note**
>
> La clé API doit disposer des autorisations `convai_read`, `user_read` et `voices_read`.

#### Enregistrez votre clé API ElevenLabs auprès de LiveAvatar

LiveAvatar exige que votre clé API ElevenLabs soit enregistrée via son endpoint de secrets. Cet enregistrement chiffre votre clé avec Amazon KMS et renvoie un `secret_id` à utiliser dans les sessions.

Envoyez une requête POST à l'endpoint de secrets de LiveAvatar :

```bash
curl -X POST "https://api.liveavatar.com/v1/secrets" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <your_heygen_api_key>" \
  -d '{
    "secret_type": "ELEVENLABS_API_KEY",
    "secret_value": "<your_secret_value>",
    "secret_name": "<your_secret_name>"
  }'
```

La réponse contient votre `secret_id`. Conservez ce `secret_id` pour l'utiliser au démarrage des sessions.

#### Démarrez une session LiveAvatar

Au démarrage d'une session LiveAvatar, utilisez le mode LITE et incluez votre configuration ElevenAgents :

```json
{
  "mode": "LITE",
  "elevenlabs_agent_config": {
    "secret_id": "xxxxxxxxxxxxxxxx",
    "agent_id": "agent_xxxxxxxxxxxxxxxx"
  },
  "avatar_id": "xxxxx"
}
```

Consultez la [documentation de l'API de session LiveAvatar](https://docs.liveavatar.com) pour connaître tous les détails de gestion des sessions.

## Événements et callbacks

L'intégration transmet des événements via des salles LiveKit, en utilisant la même structure d'événements que le mode FULL de LiveAvatar. Vous pouvez ainsi :

* Surveiller les changements d'état de la conversation
* Suivre les modes de parole et d'écoute de l'agent
* Gérer les événements de connexion et de déconnexion
* Traiter les transcriptions et les réponses de l'agent

Configurez vos gestionnaires d'événements conformément à la [documentation des événements LiveAvatar](https://docs.liveavatar.com).

## Facturation

Cette intégration implique une facturation distincte sur les deux plateformes :

| Composant                         | Facturation                                                                              |
| --------------------------------- | ---------------------------------------------------------------------------------------- |
| LiveAvatar (vidéo de l'avatar)    | 1 crédit par minute de session                                                           |
| ElevenLabs (IA conversationnelle) | Facturé sur votre compte ElevenLabs selon votre [forfait](https://elevenlabs.io/pricing) |

Le streaming de l'avatar est facturé uniquement pour la composante vidéo, tandis que toute l'utilisation des agents, audio et LLM, est facturée séparément sur votre compte ElevenLabs.

## Ressources

* [Documentation du plugin LiveAvatar ElevenLabs Agent](https://docs.liveavatar.com/docs/elevenlabs-agent-plugin)
* [Guide de l'API LiveAvatar](https://docs.liveavatar.com/reference)
* [Démarrage rapide d'ElevenAgents](/docs/fr/eleven-agents/quickstart)
* [Guide de l'API ElevenAgents](/docs/fr/api-reference/agents/create)