> 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

## Visão geral

A integração com o LiveAvatar conecta o ElevenAgents à plataforma [LiveAvatar](https://docs.liveavatar.com) 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.

```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é-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](/docs/pt/eleven-agents/quickstart))

> **Note**
>
> 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

#### Obtenha suas credenciais da ElevenLabs

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

1. **ID do agente**: acesse [Plataforma de Agentes > Agentes](https://elevenlabs.io/app/agents/agents) e copie o ID do agente que você deseja usar

2. **Chave de API**: acesse [Configurações > Chaves de API](https://elevenlabs.io/app/settings/api-keys) e gere uma nova chave de API (ou use uma existente)

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

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

```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>"
  }'
```

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

#### Inicie uma sessão do LiveAvatar

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

```json
{
  "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](https://docs.liveavatar.com) 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](https://docs.liveavatar.com).

## Cobrança

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

| Componente                     | Cobranç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](https://elevenlabs.io/pricing) |

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

* [Documentação do plugin do ElevenLabs Agent para LiveAvatar](https://docs.liveavatar.com/docs/elevenlabs-agent-plugin)
* [Referência da API do LiveAvatar](https://docs.liveavatar.com/reference)
* [Início rápido do ElevenAgents](/docs/pt/eleven-agents/quickstart)
* [Referência da API do ElevenAgents](/docs/pt/api-reference/agents/create)