Actions15
Overview
The "Add Looks" operation of the Photo Avatar resource in this node allows users to add new "looks" (variations or styles) to an existing avatar group by specifying image keys and optional metadata. This is useful for enhancing a photo avatar group with additional visual appearances, enabling more diverse avatar presentations.
Typical use cases include:
- Expanding an avatar group with multiple looks generated from different images.
- Organizing avatar variations under a named look for easier management.
- Associating generated images with a specific generation job for traceability.
For example, if you have an avatar group representing a character, you can add several looks such as different outfits or expressions by providing their image keys and optionally naming the look.
Properties
| Name | Meaning |
|---|---|
| Group ID | The unique identifier of the avatar group to which the looks will be added. |
| Image Keys | Comma-separated list of image keys (up to 4) that represent the images to add as looks. |
| Look Name | Optional name for the look being added to the avatar group. |
| Generation ID | Optional ID of the generation job used to create the images being added. |
Output
The output JSON contains the response from the HeyGen API after adding looks to the avatar group. This typically includes details about the updated avatar group and the newly added looks, such as their IDs, names, and associated image keys.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the HeyGen API service.
- Requires valid API authentication credentials configured in n8n.
- The node uses the HeyGen API version 2 endpoints for photo avatar operations.
Troubleshooting
- Invalid Group ID: If the provided Group ID does not exist or is incorrect, the API will return an error. Verify the Group ID before using it.
- Image Keys Format: Ensure the Image Keys are provided as a comma-separated string without extra spaces or invalid characters. The maximum number of image keys allowed is 4.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Confirm that the API key or token is correctly set up in n8n.
- Empty Required Fields: The Group ID is required; omitting it will result in an error.
- Generation ID Mismatch: If a Generation ID is provided, it must correspond to the images being added; otherwise, the API may reject the request.
Links and References
- HeyGen API Documentation (general reference for API endpoints)
- n8n Documentation (for configuring credentials and using custom nodes)