GuidesRecettes

LiveAvatar

Découvrez comment intégrer ElevenAgents à LiveAvatar de HeyGen pour le streaming d’avatars en temps réel

Présentation

L’intégration LiveAvatar connecte ElevenAgents à la plateforme LiveAvatar 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.

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

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

1

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 et copiez l’ID de l’agent que vous souhaitez utiliser

  2. Clé API : accédez à Settings > API Keys et générez une nouvelle clé API, ou utilisez-en une existante

La clé API doit disposer des autorisations convai_read, user_read et voices_read.

2

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 :

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.

3

Démarrez une session LiveAvatar

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

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

Consultez la documentation de l’API de session LiveAvatar 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.

Facturation

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

ComposantFacturation
LiveAvatar (vidéo de l’avatar)1 crédit par minute de session
ElevenLabs (IA conversationnelle)Facturé sur votre compte ElevenLabs selon votre forfait

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