GuíasRecetarios

LiveAvatar

Aprende a integrar ElevenAgents con LiveAvatar de HeyGen para transmitir avatares en tiempo real

Descripción general

La integración con LiveAvatar conecta ElevenAgents con la plataforma LiveAvatar de HeyGen para crear experiencias interactivas con avatares. Esta integración combina ElevenLabs Agents (que gestiona las interacciones de audio) con la transmisión de vídeo de avatares en tiempo real de LiveAvatar, lo que permite conversaciones visuales con avatares de IA de baja latencia.

Con esta integración puedes:

  • Implementar agentes de IA conversacional con representación visual mediante avatar
  • Crear experiencias interactivas de atención al cliente con avatares realistas
  • Crear asistentes virtuales atractivos para sitios web y aplicaciones

Cómo funciona

La integración utiliza el modo de sesión LITE de LiveAvatar, en el que las responsabilidades se dividen entre las dos plataformas:

  • ElevenLabs: gestiona la transmisión y la orquestación de la entrada y salida de audio
  • LiveAvatar: gestiona el renderizado de avatares y la transmisión de vídeo en tiempo real

Cuando se inicia una sesión en modo LITE con una configuración de ElevenAgents, LiveAvatar asigna un worker que se conecta a tu agente de ElevenLabs. La salida de audio del agente controla la sincronización labial y las animaciones del avatar en tiempo real.

Requisitos previos

Antes de configurar la integración, asegúrate de tener:

  1. Una cuenta de ElevenLabs con acceso a la API
  2. Una cuenta de HeyGen LiveAvatar con acceso a la API
  3. Un agente de ElevenLabs (crea uno siguiendo la guía de inicio rápido)

El agente de ElevenLabs debe tener configurados los formatos de entrada y salida de audio en PCM a 24 000 Hz. Puedes configurarlo en Ajustes de voz > Formatos de salida de TTS y Avanzado > Formato de audio de entrada del usuario.

Configuración

1

Obtén tus credenciales de ElevenLabs

Necesitas dos elementos de tu cuenta de ElevenLabs:

  1. ID del agente: ve a Plataforma de Agents > Agentes y copia el ID del agente que quieras utilizar

  2. Clave de API: ve a Ajustes > Claves de API y genera una clave de API nueva (o usa una existente)

La clave de API debe tener los permisos convai_read, user_read y voices_read.

2

Registra tu clave de API de ElevenLabs en LiveAvatar

LiveAvatar requiere que registres tu clave de API de ElevenLabs mediante su ruta de API de secretos. Este registro cifra tu clave con Amazon KMS y devuelve un secret_id para usarlo en las sesiones.

Haz una solicitud POST a la ruta de API de secretos de LiveAvatar:

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

La respuesta contiene tu secret_id. Guarda este secret_id para usarlo al iniciar sesiones.

3

Inicia una sesión de LiveAvatar

Al iniciar una sesión de LiveAvatar, utiliza el modo LITE e incluye la configuración de ElevenAgents:

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

Consulta la documentación de la API de sesiones de LiveAvatar para obtener información completa sobre la gestión de sesiones.

Eventos y callbacks

La integración envía eventos a través de salas de LiveKit y utiliza la misma estructura de eventos que el modo FULL de LiveAvatar. Esto te permite:

  • Supervisar los cambios de estado de la conversación
  • Seguir los modos de habla y escucha del agente
  • Gestionar los eventos de conexión y desconexión
  • Procesar transcripciones y respuestas del agente

Configura tus gestores de eventos según la documentación de eventos de LiveAvatar.

Facturación

Esta integración implica una facturación independiente en ambas plataformas:

ComponenteFacturación
LiveAvatar (vídeo del avatar)1 crédito por minuto de sesión
ElevenLabs (IA conversacional)Se factura a tu cuenta de ElevenLabs según tu plan de suscripción

La transmisión del avatar se factura únicamente por el componente de vídeo, mientras que todo el uso de agentes (audio y LLM) se cobra por separado a través de tu cuenta de ElevenLabs.

Recursos