HeyGenInstall

Summary

Create a HeyGen v3 video by sending either a raw JSON request body or fields for one visual source, voice input, dimensions, background, captions, and optional metadata. The operation returns HeyGen’s API response for the video creation request.

Inputs

• Authentication — Choose OAuth2 (default) or API Key credentials.
• Define Body Using JSON — When enabled, send the JSON Body object as-is to POST /v3/videos; the structured fields below are not used.
• JSON Body — Raw JSON object for POST /v3/videos; required when JSON mode is enabled.
• Visual Source — Select exactly one source: Avatar ID, Image URL, or Image Asset ID. The selected source value is required.
• Video Type — Request type field; defaults to avatar.
• Voice — Choose Text to Speech, Audio URL, or None. Text mode can include Script, Voice ID, and Voice Speed; audio mode can include Audio URL.
• Video Dimensions — Width and height, defaulting to 1280×720. The node derives aspect_ratio as 9:16 when height exceeds width, otherwise 16:9; it sets resolution to 1080p when height is at least 1080, otherwise 720p.
• Background — Choose none, color, image, or video URL and provide the corresponding color or URL. The video URL option is sent as an image-type background.
• Caption — Whether to set enable_caption; defaults to false.
• Additional Fields — Optional callback ID, callback URL, folder ID, test flag, and title. The test flag defaults to false.

Output shape

A single n8n item per input item, containing HeyGen's API response in its json field.

The operation submits a POST request to /v3/videos. In structured mode, the selected visual source must have a non-empty value. In text voice mode, script and voice ID are included only when provided; in audio mode, audio_url is included only when provided. With JSON mode enabled, the supplied object is passed through unchanged.

Links

• n8n community nodes installation guide