> 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

## Översikt

LiveAvatar-integrationen kopplar ElevenAgents till HeyGens [LiveAvatar](https://docs.liveavatar.com)-plattform för att skapa interaktiva avatarupplevelser. Integrationen kombinerar ElevenLabs Agents (som hanterar ljudinteraktioner) med LiveAvatars videostreaming av avatarer i realtid, vilket möjliggör visuella samtal med AI-avatarer med låg fördröjning.

Med den här integrationen kan du:

* Driftsätta AI-agenter för samtal med visuella avatarer
* Skapa interaktiva kundserviceupplevelser med verklighetstrogna avatarer
* Bygga engagerande virtuella assistenter för webbplatser och appar

## Så fungerar det

Integrationen använder LiveAvatars LITE-sessionsläge, där ansvaret delas mellan de två plattformarna:

* **ElevenLabs**: Hanterar streaming och orkestrering av ljud in och ut
* **LiveAvatar**: Hanterar avatarrendering och videostreaming i realtid

När en session i LITE-läge startar med en ElevenAgents-konfiguration skickar LiveAvatar ut en worker som ansluter till din ElevenLabs-agent. Agentens ljudutdata styr avatarens läppsynkronisering och animationer i realtid.

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

## Förutsättningar

Innan du konfigurerar integrationen, se till att du har:

1. Ett ElevenLabs-konto med API-åtkomst
2. Ett HeyGen LiveAvatar-konto med API-åtkomst
3. En ElevenLabs-agent (skapa en genom att följa [snabbstartsguiden](/docs/sv/eleven-agents/quickstart))

> **Note**
>
> ElevenLabs-agenten måste ha ljudformat för in- och utdata inställda på PCM 24000 Hz. Detta kan
> ställas in i röstinställningarna > TTS-utdataformat och Avancerat > Ljudformat för användarindata.

## Konfiguration

#### Hämta dina ElevenLabs-uppgifter

Du behöver två saker från ditt ElevenLabs-konto:

1. **Agent-ID**: Gå till [Agents Platform > Agents](https://elevenlabs.io/app/agents/agents) och kopiera ID:t för agenten du vill använda

2. **API-nyckel**: Gå till [Settings > API Keys](https://elevenlabs.io/app/settings/api-keys) och skapa en ny API-nyckel (eller använd en befintlig)

> **Note**
>
> API-nyckeln måste ha behörigheterna `convai_read`, `user_read` och `voices_read`.

#### Registrera din ElevenLabs API-nyckel hos LiveAvatar

LiveAvatar kräver att din ElevenLabs API-nyckel registreras via deras secrets-slutpunkt. Registreringen krypterar din nyckel med Amazon KMS och returnerar ett `secret_id` som används i sessioner.

Gör en POST-begäran till LiveAvatars secrets-slutpunkt:

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

Svaret innehåller ditt `secret_id`. Spara detta `secret_id` för användning när du startar sessioner.

#### Starta en LiveAvatar-session

När du startar en LiveAvatar-session använder du LITE-läget och inkluderar din ElevenAgents-konfiguration:

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

Se [LiveAvatars API-dokumentation för sessioner](https://docs.liveavatar.com) för fullständig information om sessionshantering.

## Händelser och callbacks

Integrationen levererar händelser via LiveKit-rum och använder samma händelsestruktur som LiveAvatars FULL-läge. Detta gör att du kan:

* Övervaka ändringar i samtalets status
* Spåra när agenten talar och lyssnar
* Hantera anslutnings- och frånkopplingshändelser
* Bearbeta transkriberingar och agentsvar

Konfigurera dina händelsehanterare enligt [LiveAvatars händelsedokumentation](https://docs.liveavatar.com).

## Fakturering

Den här integrationen har separat fakturering från båda plattformarna:

| Komponent                  | Fakturering                                                                                          |
| -------------------------- | ---------------------------------------------------------------------------------------------------- |
| LiveAvatar (avatarvideo)   | 1 kredit per sessionsminut                                                                           |
| ElevenLabs (AI för samtal) | Faktureras till ditt ElevenLabs-konto enligt din [prenumerationsplan](https://elevenlabs.io/pricing) |

Avatarstreamingen faktureras endast för videokomponenten, medan all agentanvändning (ljud och LLM) debiteras separat via ditt ElevenLabs-konto.

## Resurser

* [Dokumentation för LiveAvatar ElevenLabs Agent Plugin](https://docs.liveavatar.com/docs/elevenlabs-agent-plugin)
* [LiveAvatar API-referens](https://docs.liveavatar.com/reference)
* [Snabbstart för ElevenAgents](/docs/sv/eleven-agents/quickstart)
* [ElevenAgents API-referens](/docs/sv/api-reference/agents/create)