We’ve added a new endpoint to retrieve dynamic and custom variables defined in your AI Studio templates.

Endpoint: v3/template/<template_id> This endpoint allows developers to programmatically access all variable definitions — including avatar, text and elements and media (e.g. image, video, etc.) — that can be dynamically populated during video generation. It enables full integration of AI-powered avatar video creation workflows using your own template schema.

Reference: https://docs.heygen.com/reference/get-template-v3#/

(Note: This refers to avatar versions, not API versions.)

The Streaming API has officially deprecated Interactive Avatar Versions v1 and v2.
To continue using the service, please upgrade to v3 or higher immediately.

  • v1 and v2 → No longer supported
  • v3+ → Required going forward

Deprecated versions will return errors. Full details & migration help.

Endpoint: /v1/streaming.new
Reference: https://docs.heygen.com/reference/new-session

A new parameter activity_idle_timeout has been added to the streaming.new endpoint.
It specifies the maximum idle time (in seconds) after the last user interaction before the session is marked as inactive.Default: 120 seconds, Range: 30 to 3600 seconds. This gives you greater control over session lifecycle management and resource usage.