Changelog

​

Delete Session Events endpoint

• DELETE /v1/sessions/{session_id}/events — New endpoint to hard-delete all events for a given session. Accepts session_id path parameter; authenticated via API key or bearer token.

​

JavaScript SDK v0.0.18 — ElevenLabs Agent improvements

• @heygen/liveavatar-web-sdk v0.0.18 — Includes a set of ElevenLabs Agent connector improvements, notably bidirectional passthrough of raw ElevenLabs Conversational AI events. Frontends can now both receive every ElevenLabs server event (via elevenlabs_agent_event) and send raw ElevenLabs client events (via elevenlabs_agent_command) without per-feature plumbing.

​

1080p avatars, ElevenLabs voice override & expanded Gemini voices

• 1080p avatars — Added support for 1080p avatars on the new payment plan. AvatarSchema exposes an is_1080p boolean to identify them.
• Session token improvements — Hardened JWT payload to strip sensitive fields from the token, also reducing payload size. Sandbox mode keeps fields visible for testing.
• ElevenLabs voice override — ElevenLabsAgentConfigSchema accepts an optional voice_id that is forwarded as conversation_config_override.tts.voice_id to the ElevenLabs Agent WebSocket, overriding the agent’s default voice for the session.
• Expanded Gemini Realtime voices — GeminiVoiceEnum adds Achernar, Achird, Algenib, Algieba, Alnilam, Autonoe, Callirrhoe, Despina, Enceladus, Erinome, Gacrux, Iapetus, Laomedeia, Pulcherrima, Rasalgethi, Sadachbia, Sadaltager, Schedar, Sulafat, Umbriel, Vindemiatrix, and Zubenelgenubi.

​

Gemini Realtime, Vertical Embeds & Dynamic Variables

• Gemini Realtime agent — LITE sessions can now be configured with gemini_realtime_config, running on Gemini Live API with configurable model, voice, and temperature. Supported voices include Aoede, Charon, Fenrir, Kore, Leda, Orus, Puck, and Zephyr. Requires a new GEMINI_API_KEY secret type.
• Embed orientation — /v2/embeddings now accepts an orientation field (horizontal for 16:9 or vertical for 9:16). The response also returns the new embed_id field.
• Session dynamic variables — Session creation now accepts a dynamic_variables object for filling ${var} placeholders in the context’s opening text and prompt (max 50 entries).
• New session filters — GET /v1/sessions now supports embed_id and context_id query parameters.
• New AGENT_HANG_UP session end reason — Added to SessionEndReasonEnum to indicate the agent itself terminated the call. Currently only emitted by the ElevenLabs agent.

​

ElevenLabs Events, Embed Transcripts & SDK Update

• ElevenLabs agent events — underlying ElevenLabs server events are now forwarded via the elevenlabs_agent_event event type, giving you access to raw ElevenLabs Conversational AI events
• Transcript on embed — Transcripts are now available directly on embed sessions
• JavaScript SDK updated — Updated the @heygen/liveavatar-web-sdk package with new event types and improvements

​

Auth Simplification & Session Filtering

• Authentication — Cleaned up documentation for which endpoints require which auth specifications
• New avatar_id filter on /v1/sessions — List sessions can now be filtered by an optional avatar_id query parameter

​

Embeds, Image Avatars & More

• New /v2/embeddings endpoint with sandbox support — Embeds can now be created with Sandbox Mode available
• Built Image Avatar pipeline — Create a fully animated avatar from just a photo using the new validate and submit endpoints

​

Improvements

• Update avatar endpoint — You can now change an avatar’s default voice
• Avatar and voice deletion untangled — Deleting a voice no longer affects its associated avatar, and vice versa
• ElevenLabs agent dynamic variables — Configure dynamic variables for ElevenLabs-powered agents that get replaced at session start
• Source events fixed in FULL Mode — avatar.say and avatar.repeat events now correctly return source_event_id

​

ElevenLabs Scribe, Embed Improvements

• Added support for ElevenLabs Scribe, expanding ASR capabilities
• Embed Improvements
  • Default language selection, letting users set the language for their embed experience
  • Time limits, giving creators control over session duration

​

Voice Settings & Fish Audio

• Added additional voice settings for more granular control over avatar speech
• Added access to Fish Audio as a TTS provider
• New [GET] /v1/languages endpoint to clarify which languages are currently supported

​

ElevenLabs Integration

• The v1/secrets endpoint now accepts ElevenLabs API keys
• FULL Mode sessions can now start with your own ElevenLabs keys and voices
• Added integration with ElevenLabs Agent functionality

​

LLM Plugin & Session Controls

• Introduced LLM Plugin for custom LLM configurations
• Added customizable session duration controls
• Transcription chunk events are now emitted in real time
• New endpoint to track user credit balances

​

Session Configuration & LITE Mode

• New session configuration options for video codec selection (H.264 / VP8)
• Added video quality control settings
• Added voice customization options
• CUSTOM Mode has been renamed to LITE Mode (backward-compatible)
• Bug fix: resolved opening line speech issues

​

Push-to-Talk

• Released Push-to-Talk functionality for avatar sessions
• Added accompanying documentation and integration guides

​

Sandbox Mode & FULL Mode Improvements

• Introduced Sandbox Mode for testing without credit charges
• Made context optional in FULL Mode configurations, reducing required setup

​

Custom Mode & Session List Updates

• Custom Mode now exposes LiveKit Agent token for developers to integrate their own agents
• Session List endpoint updated to use query parameters

​

Transcription Endpoint

• New [GET] /v1/sessions/{session_id}/transcript endpoint
• Enables developers to retrieve transcriptions between users and avatars in FULL Mode sessions

​

Sessions List Endpoint

• New [GET] /v1/sessions endpoint
• Allows listing of both active and previously active sessions