Actions22
- Video Actions
- Avatar Actions
- Voice Actions
- Template Actions
- Product Actions
- AI Script Actions
- File Actions
- Visual Style Actions
- Webhook Actions
Overview
The node integrates with the JoggAI API to generate AI-created avatar photos based on user-defined parameters. It is particularly useful for creating personalized avatars for social media profiles, professional networking sites, marketing materials, or any application requiring customized human-like images without needing actual photographs.
For example, a user can generate a professional-looking avatar of a young adult female with specific ethnic features and background settings, which can be used as a profile picture on LinkedIn or company websites.
Properties
| Name | Meaning |
|---|---|
| Age | The age group of the avatar. Options: Teenager, Young Adult, Adult, Elderly. |
| Aspect Ratio | The aspect ratio of the generated photo. Options: Portrait [9:16], Landscape [16:9]. |
| Avatar Style | The overall style of the avatar photo. Options: Professional, Social. |
| Gender | The gender of the avatar. Options: Male, Female. |
| Model | The generation model to use. Options: Classic, Modern. |
| Optional Details | Additional customization options including: • Ethnicity (No Select, European, African, South Asian, East Asian, Middle Eastern, South American, North American) • Appearance (free text description, e.g., "wearing a red dress, has blonde hair") • Background (free text description, e.g., "in a modern office, outdoor cafe") • Reference Image URL (URL to an image to use as reference) |
Output
- The node outputs JSON data representing the generated avatar photo details.
- Typically, this includes URLs or identifiers for the generated image(s).
- If binary data output is supported (not explicitly shown in the provided code), it would represent the actual image file content.
- The output structure allows downstream nodes to access the generated avatar image for further processing or storage.
Dependencies
- Requires an active connection to the JoggAI API service.
- Needs an API key credential configured in n8n for authentication with the JoggAI API.
- No other external dependencies are indicated in the source code.
Troubleshooting
Common Issues:
- Invalid or missing API key credential will cause authentication failures.
- Providing unsupported or invalid property values may result in API errors.
- Network connectivity issues can prevent successful API calls.
- Reference Image URL must be accessible and valid; otherwise, the avatar generation might fail or ignore the reference.
Error Messages:
- Errors from the API are caught and logged with a prefix indicating failure in the node.
- If "Continue On Fail" is enabled, the node returns error details per item instead of stopping execution.
- To resolve errors, verify API credentials, input parameter correctness, and network status.
Links and References
- JoggAI Official Documentation (placeholder link, replace with actual documentation URL)
- n8n Documentation on Creating Custom Nodes
- General information on AI-generated avatars and ethical considerations (various online resources)