HeyGen icon

HeyGen

Consume HeyGen API

Document → Upload

AI-generated

Overview

This node uploads a document to the HeyGen API. It supports uploading either binary data directly from the workflow's binary field or by fetching a file from a provided URL. This is useful for scenarios where you need to programmatically upload documents such as images, videos, or audio files to HeyGen for further processing or storage.

Use Case Examples

  1. Uploading an image file stored in the workflow's binary data to HeyGen.
  2. Uploading a video file by providing its URL to HeyGen.

Properties

Name Meaning
Binary Data Determines if the data to upload should be taken from the binary field of the input item.
Binary Property The name of the binary property that holds the data to upload. Required if Binary Data is true.
File URL The URL of the file to upload. Required if Binary Data is false.

Output

JSON

  • id - The unique identifier of the uploaded document asset returned by HeyGen.
  • url - The URL of the uploaded document asset.
  • mimeType - The MIME type of the uploaded document.

Dependencies

  • HeyGen API with an API key credential

Troubleshooting

  • If 'No binary data exists on item!' error occurs, ensure the input item contains binary data when Binary Data is true.
    If 'No binary data property "" exists on item!' error occurs, verify the binary property name matches the actual binary data property.
  • If 'File URL is required!' error occurs, provide a valid file URL when Binary Data is false.
  • Ensure the file URL is accessible and returns the file data correctly for upload.
  • Check MIME type detection logic if the uploaded file type is incorrect or unsupported.

Discussion