HeyGen Launches Cinematic Avatar API for Agent-Driven Video Pipelines

HeyGenHeyGen

· Updated

HeyGen has launched its Cinematic Avatar API, allowing developers to programmatically generate cinematic videos featuring their likeness. This enables coding agents to build automated video pipelines, transforming natural language prompts into professional video content.

HeyGen has released its Cinematic Avatar API, a prompt-driven variant of its video creation endpoint. This API allows users to generate cinematic avatar videos by describing the desired scene, action, and framing in natural language, rather than providing a script and voice. It supports one to three avatar look IDs and optional reference videos or images to guide style, motion, or composition.
Prompt Length
1–10,000 characters
Avatar Looks per Shot
1–3 IDs
Reference Media Limit
Up to 3 videos / 9 images
Video Duration
4–15 seconds
Resolution Options
720p, 1080p
Aspect Ratio Options
16:9, 9:16, 1:1

This update enables programmatic control over video production, integrating with the HeyGen CLI and a HyperFrames skill to facilitate automated workflows. By exposing cinematic video generation via an API, HeyGen allows coding agents (AI systems that can autonomously plan, reason, use tools, and take multi-step actions to achieve goals) to build sophisticated video pipelines.

Developers can use the API to create launch videos, real estate tours, or financial reports by sending a POST request to the /v3/videos endpoint with type: "cinematic_avatar". The process is asynchronous, requiring polling or webhooks for completion. The API supports various parameters including prompt, avatar_id, references, aspect_ratio, resolution, and duration.

View the full update on developers.heygen.com
HeyGen
HeyGen
@HeyGen
X

Cinematic_avatar api is live keep your likeness, add cinematic range and build your video pipeline via your coding agent install HeyGen CLI + HyperFrames skill to create launch videos like ours docs and cli setup in thread ↓ https://t.co/TEpepD94yw

192retweets684likes
View on X

Still wondering? A few quick answers below.

The Cinematic Avatar API is a new offering from HeyGen that allows developers to generate cinematic videos featuring AI avatars. Instead of providing a script and voice, users describe the desired scene, action, and framing using a natural language prompt.

Users send a `POST` request to HeyGen's `/v3/videos` endpoint, specifying `"cinematic_avatar"` as the video type. They include a text prompt, one to three avatar look IDs, and optionally, reference media to guide the video's style and motion.

The API is designed for creating professional, cinematic-style videos. Examples include launch videos, real estate tours, financial reporting, and other use cases where high-quality, automated video content featuring avatars is needed.

Developers can integrate the API using the HeyGen CLI and a HyperFrames skill. This allows coding agents to programmatically generate videos, manage the video pipeline, and automate multi-step video production tasks directly from the terminal.

Yes, the API supports adding reference media such as videos and images. These references can be provided via URL, asset ID, or base64 input, and they help steer the style, motion, or composition of the generated cinematic avatar video.

Every HeadsUpAI update is written based on its original source and reviewed before it's published. Read our editorial standards →

HeyGen

See all AI news & updates from HeyGen →

Share this update