Nodaro Docs
DocumentationNode ReferenceModelsAI Agents (MCP)DevelopersSelf-hostingResearch
Video

Cinematic Avatar

Make a short cinematic clip with 1 to 3 HeyGen avatar looks from a text prompt. No script or voice; the prompt directs the scene, action and camera.

The Cinematic Avatar node makes a short cinematic clip that features 1 to 3 HeyGen avatar looks. There is no script and no voice: a text prompt describes the scene, the action and the direction, and HeyGen renders the clip with the looks you chose.

When to use it

  • A cinematic intro, a teaser or a stylized moment for a presenter you already use in AI Avatar.
  • A story beat with a consistent set of avatar looks.
  • A quick generative clip that needs no lip-synced narration.

For a talking-head video with a script or a voiceover, use AI Avatar instead.

Quick start

Add the node

Press Tab on the canvas and choose Video › Animate & Perform › Cinematic Avatar.

Pick the avatar looks

Select the node. Under Avatar Looks, pick 1 to 3 looks from the searchable avatar catalog, with a preview of each.

Describe the scene

Write the Prompt: the scene, the mood, the camera and the action. Or connect a text node to the Prompt input.

Set the clip and run it

Choose the Duration, Aspect Ratio and Resolution, then click Run. The clip appears on the node.

promptpromptTextRooftop at night, slow orbitMoodMysteriousCinematic Avatar2 looks · 10 sCombine Videos
A written scene and a Mood picker direct a Cinematic Avatar clip, which opens a longer edit.

Inputs

InputAcceptsWhat it does
PromptText nodes and pickersThe scene to render. You can also type it in the settings panel.
Video refVideo nodesOptional. A reference clip that guides the generation.
Audio refAudio nodesOptional. A reference sound that guides the generation.
Image refImage nodesOptional. A reference image that guides the generation.

The output, Video, is the URL of the clip.

Settings

SettingWhat it does
PromptThe generative prompt, from 1 to 10,000 characters. It describes what happens; it is not spoken. Required.
Avatar Looks1 to 3 HeyGen avatar looks to feature. Required.
DurationThe clip length, from 4 to 15 seconds. The default is 10.
Auto duration (let HeyGen decide)Lets HeyGen choose the length. Duration is ignored while it is on. Off by default.
Aspect Ratio16:9 (the default), 9:16 or 1:1.
Resolution720p (the default) or 1080p.
Enhance promptAsks HeyGen to improve your prompt before it renders. Off by default.
Pre & post textText always added before and after the prompt. It is hidden from people who use your workflow as an app. See Prompt pre and post text.

Because the prompt is a real generative prompt, the Prompt Wizard and field mappings work on this node.

Credits

The price depends on the resolution and the length of the clip. The editor shows the cost before you run.

  • A hold, then the real charge. Credits are reserved when the run starts. The final charge follows the real length of the clip, and the rest is refunded.
  • Auto duration does not know the length in advance, so it reserves the price of a 15-second clip at your resolution, and refunds the difference when the clip is ready.
  • The cheapest clip is 4 seconds at 720p; the most expensive is 15 seconds at 1080p.

When HeyGen is not set up

On a self-hosted install without a HeyGen key, the avatar picker is empty and shows a notice, and a run fails with the error heygen_not_configured. Add a HeyGen key or connect to Nodaro Cloud. See Cloud connect.

Tips

  • Direct, do not narrate. Describe the scene, the mood, the camera and the action. The prompt is not read aloud.
  • One look for one subject. Use 2 or 3 looks only when the scene needs several characters.
  • Draft short. Start at 720p with a short duration, then raise the resolution and the length for the final clip.
  • Go vertical or square for social. 9:16 suits TikTok, Instagram Reels and YouTube Shorts; 1:1 suits square posts.

Frequently asked questions

Last updated on

On this page