LiveAvatar Debugging Guide

Symptom-based troubleshooting for LiveAvatar integrations. Find your symptom below and follow the fix.

Avatar is silent / not responding to speech

Most likely: Missing context_id in FULL Mode.

Without a context_id, the avatar enters restricted mode — streams video but ignores user input. No error thrown.

Fix: Create a context via POST /v1/contexts with at least a prompt field. Include the returned context_id in your session token's avatar_persona.

Other causes:

• Browser mic permissions blocked (check allow="microphone" on iframe)
• Push-to-Talk enabled but PTT events not being sent
• OS-level mic mute

Audio is garbled or distorted (LITE Mode)