Heygen Node for n8n

This is an n8n node to interact with the Heygen API to generate AI avatar videos and more.

Installation

Via npm

npm install @1kdanny/n8n-nodes-heygen

Local Development

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Build the node:

   npm run build
   

4. Link the package for local development:

   ./install-local.sh
   

Credentials

To use this node, you'll need a Heygen API key, which you can obtain from your Heygen dashboard.

Operations

The Heygen node supports the following operations:

Generate Avatar Video

Creates a new video with a selected avatar and voice.

Parameters:

• Avatar ID: ID of the avatar to use
• Voice ID: ID of the voice to use
• Input Text: The text for the avatar to speak
• Background (optional): Background URL or ID
• Video Dimension (optional): Dimensions of the output video (1920x1080, 1080x1920, or 1080x1080)

List Avatars

Returns a list of all available avatars in your Heygen account.

List Voices

Returns a list of all available voices in your Heygen account.

Check Video Status

Checks the status of a video generation job.

Parameters:

• Video ID: ID of the video to check status for

Troubleshooting

Icons not displaying

• Clear browser cache and restart n8n
• Verify that the icons are correctly copied to the dist folder after building

Installation issues

• Make sure package.json correctly points to the compiled files in dist
• Check that you're using the correct version of n8n

License

MIT