> 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

## Overzicht

De LiveAvatar-integratie verbindt ElevenAgents met het [LiveAvatar](https://docs.liveavatar.com)-platform van HeyGen om interactieve avatarervaringen te creëren. Deze integratie combineert ElevenLabs Agents (voor audio-interacties) met realtime videostreaming van avatars van LiveAvatar, waardoor visuele gesprekken met AI-avatars met lage latentie mogelijk zijn.

Met deze integratie kun je:

* conversationele AI-agents met een visuele avatarrepresentatie implementeren
* interactieve klantenservice-ervaringen met levensechte avatars creëren
* aantrekkelijke virtuele assistenten voor websites en applicaties bouwen

## Zo werkt het

De integratie gebruikt de LITE-sessiemodus van LiveAvatar, waarbij de verantwoordelijkheden tussen de twee platforms worden verdeeld:

* **ElevenLabs**: Verzorgt de streaming en orkestratie van audio-invoer en -uitvoer
* **LiveAvatar**: Beheert het renderen van avatars en realtime videostreaming

Wanneer een sessie in de LITE-modus start met een ElevenAgents-configuratie, stuurt LiveAvatar een worker aan die verbinding maakt met je ElevenLabs-agent. De audio-uitvoer van de agent stuurt de lipsynchronisatie en animaties van de avatar in realtime aan.

```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
```

## Vereisten

Controleer vóór je de integratie instelt of je het volgende hebt:

1. Een ElevenLabs-account met API-toegang
2. Een HeyGen LiveAvatar-account met API-toegang
3. Een ElevenLabs-agent (maak er een volgens de [quickstartgids](/docs/nl/eleven-agents/quickstart))

> **Note**
>
> Voor de ElevenLabs Agent moeten de audio-invoer- en uitvoerformaten zijn ingesteld op PCM 24000 Hz. Dit kun je
> instellen via Voice settings > TTS output formats en Advanced > User input audio format.

## Instellen

#### Je ElevenLabs-inloggegevens ophalen

Je hebt twee zaken uit je ElevenLabs-account nodig:

1. **Agent-ID**: Ga naar [Agents Platform > Agents](https://elevenlabs.io/app/agents/agents) en kopieer de ID van de agent die je wilt gebruiken

2. **API-sleutel**: Ga naar [Settings > API Keys](https://elevenlabs.io/app/settings/api-keys) en genereer een nieuwe API-sleutel (of gebruik een bestaande)

> **Note**
>
> De API-sleutel moet de machtigingen `convai_read`, `user_read` en `voices_read` hebben.

#### Je ElevenLabs API-sleutel registreren bij LiveAvatar

LiveAvatar vereist dat je ElevenLabs API-sleutel wordt geregistreerd via hun secrets-endpoint. Bij deze registratie wordt je sleutel versleuteld met Amazon KMS en wordt een `secret_id` teruggegeven voor gebruik in sessies.

Doe een POST-request naar het secrets-endpoint van 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>"
  }'
```

Het antwoord bevat je `secret_id`. Bewaar deze `secret_id` voor gebruik wanneer je sessies start.

#### Een LiveAvatar-sessie starten

Gebruik bij het starten van een LiveAvatar-sessie de LITE-modus en voeg je ElevenAgents-configuratie toe:

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

Bekijk de [API-documentatie voor LiveAvatar-sessies](https://docs.liveavatar.com) voor alle informatie over sessiebeheer.

## Events en callbacks

De integratie levert events via LiveKit-ruimtes, met dezelfde eventstructuur als de FULL-modus van LiveAvatar. Hiermee kun je:

* wijzigingen in de gespreksstatus volgen
* bijhouden wanneer de agent spreekt en luistert
* verbindings- en verbrekingsevents afhandelen
* transcripties en reacties van agents verwerken

Configureer je eventhandlers volgens de [documentatie over LiveAvatar-events](https://docs.liveavatar.com).

## Facturering

Deze integratie omvat afzonderlijke facturering door beide platforms:

| Onderdeel                       | Facturering                                                                                        |
| ------------------------------- | -------------------------------------------------------------------------------------------------- |
| LiveAvatar (avatarvideo)        | 1 credit per sessieminuut                                                                          |
| ElevenLabs (conversationele AI) | Gefactureerd aan je ElevenLabs-account op basis van je [abonnement](https://elevenlabs.io/pricing) |

De avatarstreaming wordt alleen gefactureerd voor de videocomponent, terwijl al het gebruik van agents (audio en LLM) afzonderlijk via je ElevenLabs-account in rekening wordt gebracht.

## Bronnen

* [Documentatie voor de LiveAvatar ElevenLabs Agent Plugin](https://docs.liveavatar.com/docs/elevenlabs-agent-plugin)
* [LiveAvatar API-referentie](https://docs.liveavatar.com/reference)
* [ElevenAgents quickstart](/docs/nl/eleven-agents/quickstart)
* [ElevenAgents API-referentie](/docs/nl/api-reference/agents/create)