Hoppa till navigering
GuiderExempelsamlingar

LiveAvatar

Lär dig hur du integrerar ElevenAgents med HeyGens LiveAvatar för avatarstreaming i realtid

Översikt

LiveAvatar-integrationen kopplar ElevenAgents till HeyGens LiveAvatar-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.

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)

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

1

Hämta dina ElevenLabs-uppgifter

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

  1. Agent-ID: Gå till Agents Platform > Agents och kopiera ID:t för agenten du vill använda

  2. API-nyckel: Gå till Settings > API Keys och skapa en ny API-nyckel (eller använd en befintlig)

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

2

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:

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.

3

Starta en LiveAvatar-session

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

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

Se LiveAvatars API-dokumentation för sessioner 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.

Fakturering

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

KomponentFakturering
LiveAvatar (avatarvideo)1 kredit per sessionsminut
ElevenLabs (AI för samtal)Faktureras till ditt ElevenLabs-konto enligt din prenumerationsplan

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

Resurser