Actions15
Overview
The "Add Motion" operation of the Photo Avatar resource in this node allows users to add motion or movement effects to an existing photo avatar. This is useful for animating static avatars, making them appear more dynamic and engaging. For example, you might have a still photo avatar and want to create subtle facial movements or gestures to bring it to life for use in videos, presentations, or interactive content.
Typical scenarios include:
- Enhancing avatars for marketing videos or social media posts.
- Creating animated characters from static images for storytelling.
- Adding natural-looking motions to avatars used in virtual assistants or chatbots.
Properties
| Name | Meaning |
|---|---|
| Prompt | A text prompt describing the type of motion or movement to add to the avatar. |
| Avatar ID | The unique identifier of the avatar to which the motion will be added. |
Output
The output JSON contains the response from the HeyGen API after requesting to add motion to the specified avatar. This typically includes details about the updated avatar or the status of the motion addition process.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the HeyGen API service.
- Requires an API authentication token configured in n8n credentials to authorize requests.
- The node uses the HeyGen API endpoint
/photo_avatar/add_motionwith a POST request.
Troubleshooting
Common issues:
- Invalid or missing Avatar ID: The operation requires a valid avatar identifier; ensure the correct ID is provided.
- Insufficient permissions or invalid API key: Verify that the API key credential is correctly set up and has access rights.
- Network or API downtime: Check network connectivity and HeyGen service status if requests fail.
Error messages:
"No binary data exists on item!"or similar errors are not relevant here since this operation does not handle binary data.- API error responses may indicate invalid parameters or rate limits; review the prompt and avatar ID inputs.
To resolve errors, verify input values, ensure proper API credentials, and consult HeyGen API documentation for specific error codes.
Links and References
- HeyGen API Documentation (general reference for API endpoints and usage)
- n8n Documentation on Creating Custom Nodes