HeyGen icon

HeyGen

Consume HeyGen API

Photo Avatar → Add Looks

AI-generated

Overview

This node operation adds new looks to an existing photo avatar group in the HeyGen platform. It allows users to specify the avatar group by its ID and add up to four image keys representing different looks. Optionally, users can name the look and provide a generation ID related to the images. This operation is useful for managing and expanding avatar appearances within a group, enabling customization and variety in avatar presentations.

Use Case Examples

  1. Adding multiple new looks to a photo avatar group by specifying the group ID and a list of image keys.
  2. Naming a new look for easier identification within the avatar group.
  3. Associating a generation ID with the added looks for tracking or reference purposes.

Properties

Name Meaning
Group ID ID of the avatar group to which looks will be added.
Image Keys Comma-separated list of image keys to add to the group (maximum 4).
Look Name Name of the look to be added, for identification purposes.
Generation ID Generation ID used to generate the images, optionally provided for reference.

Output

JSON

  • group_id - The ID of the avatar group to which looks were added.
  • image_keys - The list of image keys that were added to the avatar group.
  • name - The name of the look added to the avatar group, if provided.
  • generation_id - The generation ID associated with the added looks, if provided.

Dependencies

  • HeyGen API with API key credential

Troubleshooting

  • Ensure the Group ID is valid and exists in the HeyGen platform to avoid errors.
  • Verify that the Image Keys are correctly formatted as a comma-separated list and do not exceed four keys.
  • If providing a Generation ID, confirm it matches the images being added to prevent mismatches.
  • Common error messages may include invalid group ID, exceeding image key limits, or authentication failures. Check API credentials and input values accordingly.

Discussion