HeyGen icon

HeyGen

Consume HeyGen API

Actions18

Photo Avatar → Generate Avatar Looks

AI-generated

Overview

This node operation generates different avatar looks within a specified avatar group using a prompt and optional parameters such as orientation, pose, and style. It is useful for creating varied visual appearances for avatars in applications like virtual assistants, games, or digital marketing.

Use Case Examples

  1. Generate multiple avatar looks for a character group by providing a descriptive prompt and selecting orientation, pose, and style to customize the avatar's appearance.
  2. Create diverse avatar looks for a photo avatar group to use in social media profiles or virtual environments.

Properties

Name Meaning
Group ID ID of the avatar group to which the generated looks will be applied.
Prompt Text prompt describing the desired avatar looks or movements to generate.
Orientation Orientation for the avatar looks, such as vertical, horizontal, or square.
Pose Pose for the avatar looks, such as close up, half body, or full body.
Style Style for the avatar looks, such as realistic, Pixar, cinematic, vintage, noir, cyberpunk, or unspecified.

Output

JSON

  • group_id - ID of the avatar group for which looks were generated.
  • prompt - The prompt used to generate the avatar looks.
  • orientation - Orientation setting used for the avatar looks.
  • pose - Pose setting used for the avatar looks.
  • style - Style setting used for the avatar looks.
  • looks - Generated avatar looks data returned from the API.

Dependencies

  • HeyGen API with API key credential

Troubleshooting

  • Ensure the Group ID is valid and exists in the HeyGen system to avoid errors related to missing or invalid groups.
  • Verify that the prompt is descriptive enough to generate meaningful avatar looks.
  • Check API credentials and network connectivity if the node fails to communicate with the HeyGen API.
  • Common error messages may include invalid parameter errors if required fields like Group ID or Prompt are missing or malformed. Ensure all required fields are correctly filled.

Links

Discussion