LiveAvatar

실시간 아바타 스트리밍을 위해 ElevenAgents를 HeyGen의 LiveAvatar와 통합하는 방법 알아보기

개요

LiveAvatar 통합은 ElevenAgents를 HeyGen의 LiveAvatar 플랫폼과 연결하여 인터랙티브 아바타 경험을 만듭니다. 이 통합은 ElevenLabs Agents(오디오 상호작용 처리)와 LiveAvatar의 실시간 아바타 비디오 스트리밍을 결합해 AI 아바타와 지연 시간이 짧은 시각적 대화를 지원합니다.

이 통합으로 다음을 할 수 있습니다:

시각적 아바타로 표현되는 대화형 AI 에이전트 배포
생동감 있는 아바타로 인터랙티브 고객 서비스 경험 생성
웹사이트와 애플리케이션을 위한 매력적인 가상 어시스턴트 구축

작동 방식

이 통합은 LiveAvatar의 LITE 세션 모드를 사용하며, 두 플랫폼이 다음과 같이 역할을 나눕니다:

ElevenLabs: 오디오 입력 및 출력의 스트리밍과 오케스트레이션 처리
LiveAvatar: 아바타 렌더링 및 실시간 비디오 스트리밍 관리

ElevenAgents 구성으로 LITE 모드 세션이 시작되면 LiveAvatar는 ElevenLabs 에이전트에 연결하는 워커를 디스패치합니다. 에이전트의 오디오 출력은 아바타의 립싱크와 애니메이션을 실시간으로 구동합니다.

사전 요구 사항

통합을 설정하기 전에 다음을 준비하세요:

API 액세스 권한이 있는 ElevenLabs 계정
API 액세스 권한이 있는 HeyGen LiveAvatar 계정
ElevenLabs 에이전트(빠른 시작 가이드를 따라 생성)

ElevenLabs Agent의 오디오 입력 및 출력 형식은 PCM 24000 Hz로 설정해야 합니다. 이 설정은 Voice settings > TTS output formats 및 Advanced > User input audio format에서 변경할 수 있습니다.

설정

ElevenLabs 자격 증명 가져오기

ElevenLabs 계정에서 다음 두 가지가 필요합니다:

에이전트 ID: Agents Platform > Agents로 이동하여 사용할 에이전트의 ID를 복사합니다.
API 키: Settings > API Keys로 이동하여 새 API 키를 생성하거나 기존 키를 사용합니다.

API 키에는 convai_read, user_read, voices_read 권한이 필요합니다.

LiveAvatar에 ElevenLabs API 키 등록

LiveAvatar는 secrets 엔드포인트를 통해 ElevenLabs API 키를 등록해야 합니다. 이 등록 과정에서 Amazon KMS를 사용해 키를 암호화하고 세션에서 사용할 secret_id를 반환합니다.

LiveAvatar의 secrets 엔드포인트로 POST 요청을 보냅니다:

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

응답에는 secret_id가 포함됩니다. 세션을 시작할 때 사용할 수 있도록 이 secret_id를 저장하세요.

LiveAvatar 세션 시작

LiveAvatar 세션을 시작할 때 LITE 모드를 사용하고 ElevenAgents 구성을 포함합니다:

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

세션 관리에 관한 전체 정보는 LiveAvatar 세션 API 문서를 참조하세요.

이벤트 및 콜백

이 통합은 LiveAvatar의 FULL 모드와 동일한 이벤트 구조를 사용하여 LiveKit 룸을 통해 이벤트를 제공합니다. 이를 통해 다음을 수행할 수 있습니다:

대화 상태 변경 모니터링
에이전트의 말하기 및 듣기 모드 추적
연결 및 연결 해제 이벤트 처리
전사 및 에이전트 응답 처리

LiveAvatar 이벤트 문서에 따라 이벤트 핸들러를 구성하세요.

청구

이 통합에서는 두 플랫폼에서 각각 비용이 청구됩니다:

구성 요소	청구
LiveAvatar(아바타 비디오)	세션 분당 크레딧 1개
ElevenLabs(대화형 AI)	구독 플랜에 따라 ElevenLabs 계정으로 청구

아바타 스트리밍은 비디오 구성 요소에 대해서만 청구되며, 모든 에이전트 사용량(오디오 및 LLM)은 ElevenLabs 계정을 통해 별도로 청구됩니다.

개요