HeyGen Pro icon

HeyGen Pro

Create and monitor HeyGen avatar, template, and Video Agent videos

Video → Create Template Video

AI-generated

Summary

Generates a video from a HeyGen template using the specified template ID and template variables. Sends the request to HeyGen’s v2 template endpoint and returns the video ID with a processing status.

Inputs

  • Template ID (required) — HeyGen template ID to render.
  • Template Variables (required) — A non-empty JSON object keyed by variable name. Each value must be an object with a matching name field, a supported type (text, image, video, audio, voice, or character), and a properties object.
  • Callback URL — Optional HTTP or HTTPS URL for a callback.
  • Captions — Whether to include captions; defaults to false.
  • Scene IDs — Optional JSON array of scene IDs. When provided, scenes are rendered in the listed order.
  • Test Mode — Whether to render at lower quality without deducting quota; defaults to false.
  • Title — Optional video title.

Output shape

A single item containing video_id and status.

The status is returned as processing; this operation does not wait for rendering to finish. The Template API Notice states that template generation uses HeyGen’s supported v2 endpoint because no v3 equivalent is available.

Links

Discussion