GuiasGuias práticos

LiveAvatar

Saiba como integrar o ElevenAgents ao LiveAvatar da HeyGen para transmissão de avatares em tempo real

Visão geral

A integração com o LiveAvatar conecta o ElevenAgents à plataforma LiveAvatar da HeyGen para criar experiências interativas com avatares. Essa integração combina o ElevenLabs Agents (que gerencia as interações de áudio) com a transmissão de vídeo de avatares em tempo real do LiveAvatar, permitindo conversas visuais de baixa latência com avatares de IA.

Com esta integração, você pode:

  • Implantar agentes de IA conversacional com representação visual por avatar
  • Criar experiências interativas de atendimento ao cliente com avatares realistas
  • Desenvolver assistentes virtuais envolventes para sites e aplicativos

Como funciona

A integração usa o modo de sessão LITE do LiveAvatar, no qual as responsabilidades são divididas entre as duas plataformas:

  • ElevenLabs: gerencia o streaming e a orquestração da entrada e saída de áudio
  • LiveAvatar: gerencia a renderização de avatares e o streaming de vídeo em tempo real

Quando uma sessão no modo LITE começa com uma configuração do ElevenAgents, o LiveAvatar aciona um worker que se conecta ao seu agente da ElevenLabs. A saída de áudio do agente controla a sincronização labial e as animações do avatar em tempo real.

Pré-requisitos

Antes de configurar a integração, verifique se você tem:

  1. Uma conta da ElevenLabs com acesso à API
  2. Uma conta do HeyGen LiveAvatar com acesso à API
  3. Um agente da ElevenLabs (crie um seguindo o guia de início rápido)

O ElevenLabs Agent precisa ter os formatos de entrada e saída de áudio configurados para PCM 24000 Hz. Isso pode ser definido em Configurações de voz > Formatos de saída de TTS e Avançado > Formato de áudio de entrada do usuário.

Configuração

1

Obtenha suas credenciais da ElevenLabs

Você precisa de dois itens da sua conta da ElevenLabs:

  1. ID do agente: acesse Plataforma de Agentes > Agentes e copie o ID do agente que você deseja usar

  2. Chave de API: acesse Configurações > Chaves de API e gere uma nova chave de API (ou use uma existente)

A chave de API precisa ter as permissões convai_read, user_read e voices_read.

2

Registre sua chave de API da ElevenLabs no LiveAvatar

O LiveAvatar exige que sua chave de API da ElevenLabs seja registrada pelo endpoint de segredos. Esse registro criptografa sua chave usando o Amazon KMS e retorna um secret_id para uso nas sessões.

Faça uma solicitação POST ao endpoint de segredos do 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>"
  }'

A resposta contém seu secret_id. Guarde esse secret_id para usá-lo ao iniciar sessões.

3

Inicie uma sessão do LiveAvatar

Ao iniciar uma sessão do LiveAvatar, use o modo LITE e inclua sua configuração do ElevenAgents:

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

Consulte a documentação da API de sessões do LiveAvatar para ver todos os detalhes sobre o gerenciamento de sessões.

Eventos e callbacks

A integração entrega eventos por salas do LiveKit, usando a mesma estrutura de eventos do modo FULL do LiveAvatar. Isso permite que você:

  • Monitore mudanças no estado da conversa
  • Acompanhe os modos de fala e escuta do agente
  • Gerencie eventos de conexão e desconexão
  • Processe transcrições e respostas do agente

Configure seus manipuladores de eventos conforme a documentação de eventos do LiveAvatar.

Cobrança

Esta integração envolve cobranças separadas das duas plataformas:

ComponenteCobrança
LiveAvatar (vídeo do avatar)1 crédito por minuto de sessão
ElevenLabs (IA conversacional)Cobrado na sua conta da ElevenLabs com base no seu plano de assinatura

O streaming do avatar é cobrado apenas pelo componente de vídeo, enquanto todo o uso de agentes (áudio e LLM) é cobrado separadamente pela sua conta da ElevenLabs.

Recursos