- Support
- Integrations
- Videos
Videos
HeyGen integration · 4 node(s).
00Overview
Generate and retrieve HeyGen avatar videos
Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.
01Connecting Videos
Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:
| Field | Type | Details | |
|---|---|---|---|
| HeyGen API Key | secret | Required | ${secrets.HeyGenApiKey} |
Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.
02Generate
Generate Avatar Video
heygen/videos/generate_avatar_video · Action
Create a HeyGen talking-head video from a script (text-to-speech) or an audio URL.
| Field | Type | Details | |
|---|---|---|---|
| Avatar ID | string | Required · ● live picker | From List Avatars |
| Script (spoken text) | text | What the avatar should say (uses text-to-speech) | |
| Voice ID | string | ● live picker | Optional: blank uses the avatar's default voice |
| Audio URL | string | Alternative to a script: lip-sync to this audio | |
| Title | string | ||
| Aspect Ratio | string | choices: Auto, 16:9 (landscape), 9:16 (portrait), 1:1 (square), 4:5, 5:4 | |
| Resolution | string | choices: 1080p, 720p, 4K | |
| Voice Speed | string | 0.5 to 1.5 (default 1.0) | |
| Background Image URL | string | A room/studio image to place the avatar in | |
| Background Colour | string | #150e14 (ignored if a background image is set) | |
| Remove avatar background (needs a matting-trained avatar) | boolean | ||
| Fit | string | choices: Cover (fill, may crop), Contain (fit, may letterbox) | |
| Motion Prompt | string | e.g. gesture naturally and glance at the screen | |
| Expressiveness (photo/Avatar IV) | string | choices: High, Medium, Low | |
| Avatar Engine | string | choices: Default, Avatar III, Avatar IV, Avatar V (most dynamic) | |
| Webhook Callback URL | string | Called when the video is ready | |
| Callback ID | string | Echoed back in the webhook | |
| Advanced: extra JSON merged into the request body | text |
Returns: tool_result, video_id, status, success, error
Generate Cinematic Video
heygen/videos/generate_cinematic · Action
Generate a HeyGen video from a scene prompt — describe the setting and the avatar's motion/gestures.
| Field | Type | Details | |
|---|---|---|---|
| Avatar Look IDs | string | Required | 1 to 3, comma-separated (from List Avatars) |
| Scene & motion prompt | text | Required | Describe the setting and how the avatar moves/gestures |
| Aspect Ratio | string | choices: 16:9 (landscape), 9:16 (portrait), 1:1 (square) | |
| Resolution | string | choices: 720p, 1080p | |
| Duration (seconds, 4 to 15) | integer | ||
| Auto duration (ignore Duration) | boolean | ||
| Let HeyGen enhance the prompt | boolean | ||
| Advanced: reference assets JSON array (images/videos for style) | text | ||
| Title | string | ||
| Webhook Callback URL | string | Called when the video is ready | |
| Callback ID | string | Echoed back in the webhook |
Returns: tool_result, video_id, status, success, error
Generate Talking Photo
heygen/videos/generate_from_image · Action
Create a HeyGen video from a still photo (talking photo) speaking a script or audio.
| Field | Type | Details | |
|---|---|---|---|
| Talking Photo ID | string | A talking-photo asset uploaded to HeyGen | |
| Photo URL | string | Alternative to a Talking Photo ID: a public image URL | |
| Script (spoken text) | text | What the photo should say (uses text-to-speech) | |
| Voice ID | string | ● live picker | Optional: needed when using a script |
| Audio URL | string | Alternative to a script: lip-sync to this audio | |
| Title | string | ||
| Aspect Ratio | string | choices: Auto, 16:9 (landscape), 9:16 (portrait), 1:1 (square), 4:5, 5:4 | |
| Resolution | string | choices: 1080p, 720p, 4K | |
| Voice Speed | string | 0.5 to 1.5 (default 1.0) | |
| Background Image URL | string | A room/studio image to place the photo in | |
| Background Colour | string | #150e14 (ignored if a background image is set) | |
| Remove photo background (needs a matting-trained photo) | boolean | ||
| Fit | string | choices: Cover (fill, may crop), Contain (fit, may letterbox) | |
| Motion Prompt | string | e.g. gesture naturally and glance at the screen | |
| Expressiveness | string | choices: High, Medium, Low | |
| Webhook Callback URL | string | Called when the video is ready | |
| Callback ID | string | Echoed back in the webhook | |
| Advanced: extra JSON merged into the request body | text |
Returns: tool_result, video_id, status, success, error
03Get
Get Video
heygen/videos/get_video · Action
Get a HeyGen video's status and, when ready, its download URL.
| Field | Type | Details | |
|---|---|---|---|
| Video ID | string | Required |
Returns: tool_result, status, video_url, thumbnail_url, subtitle_url, duration, success, error