Discussions

Context - We are integrating HeyGen’s LiveAvatar (interactive avatar) API within a Supabase Edge Function in a React + Vite app (not Next.js).
We’re currently using the endpoint /v1/live_avatar.create_session (and also tried /v1/interactive_avatar.create_session and /v1/streaming.new), but consistently get either 404 Not Found or invalid avatar: not an interactive avatar errors.
We’re authenticating using the Bearer ${HEYGEN_API_KEY} format, and the same key works for other HeyGen APIs (like video creation).

Questions we need your help with -

1. API Endpoint Structure & Stability

What is the currently supported endpoint for creating a real-time interactive avatar session (e.g., /v1/live_avatar.create_session vs /v1/interactive_avatar.create_session vs /v1/streaming.new)?

We’ve seen conflicting references between the HeyGen and LiveAvatar documentation.

Does the LiveAvatar API require a different domain (e.g., api.liveavatar.com) or is it unified under api.heygen.com?

Are there any special headers (e.g., x-api-key, custom Authorization, or appId fields) required for authentication in the LiveAvatar API versus the standard HeyGen API?

2. Authentication & API Key Scoping
   Can the same API key (from HeyGen dashboard) be used for LiveAvatar / interactive sessions, or do we need a separate key from the LiveAvatar portal?
   We’ve tried Bearer token and x-api-key authentication formats — both returned 404 or 401.

If the same key works, can you confirm the correct authentication header format for LiveAvatar endpoints (Bearer vs x-api-key)?

Are there any region-specific API base URLs or deployment modes that might affect key validation (e.g., sandbox vs production)?

3. Interactive Avatar Availability
   How can we retrieve the list of interactive avatars supported for real-time streaming?
   We used GET https://api.heygen.com/v1/avatar.list and GET https://api.heygen.com/v1/streaming/avatar.list but could not find any avatars marked as interactive.
   Is there a way to identify which avatars are publicly accessible for testing (e.g., Avatar_Anna_public, Avatar_Josh_public)?
   Could you please share one working interactive avatar_id and voice_id pair that can be used for test integrations?
4. Voice ID Mapping
   How can we list or fetch available voice IDs compatible with the LiveAvatar API?
   We used IDs from the standard HeyGen voice list (e.g., heygen_english_male_1) — not sure if these work for LiveAvatar sessions.
   Are LiveAvatar voice IDs and standard HeyGen voice IDs interchangeable?
5. Debugging 400/404 Behavior
   What are the typical reasons for a 404 Not Found or 400 invalid avatar error during LiveAvatar session creation?
   Is it usually due to endpoint mismatch, missing parameters, or invalid avatar mapping?
   Could you confirm whether LiveAvatar sessions require pre-configured project or workspace IDs that must be included in the payload?
6. Integration Confirmation
   Is there a Postman collection or API reference (for developers) specifically for the LiveAvatar endpoints?
   The LiveAvatar documentation (https://docs.liveavatar.com/docs/quick-start-guide) outlines workflow steps but doesn’t include detailed endpoint specs.

Could you please share the correct API base URL, endpoint name, authentication scheme, and a working test avatar/voice ID pair for LiveAvatar session creation?

Is there a sandbox environment within LiveAvatar which could be use for testing purpose.