JoggAI icon

JoggAI

Interact with the JoggAI API to create and manage AI videos
Join our community

Actions22

Overview

The node interacts with the JoggAI API to manage various AI-powered media resources, including avatars. Specifically, for the Avatar resource and the Get Library Avatars operation, it retrieves a list of avatars from the JoggAI avatar library. Users can filter this list by multiple criteria such as age, gender, ethnicity, style, scene, and aspect ratio.

This node is beneficial in scenarios where you want to programmatically access a curated set of AI-generated avatars matching specific characteristics for use in videos, presentations, or other creative projects. For example, you might want to fetch only professional-style avatars of young adult females for a business video or select avatars with a particular ethnicity and scene setting.

Properties

Name Meaning
Filters A collection of filters to narrow down the list of avatars returned by the API. Includes:
- Age Filter avatars by age group: Adult, Senior, Young Adult, or no selection (all ages).
- Aspect Ratio Filter avatars by screen aspect ratio: [9:16], [16:9], or [1:1].
- Ethnicity Filter avatars by ethnicity: European, African, South Asian, East Asian, Middle Eastern, South American, North American, or no selection.
- Gender Filter avatars by gender: Male, Female, or no selection.
- Scene Filter avatars by scene context: Lifestyle, Outdoors, Business, Studio, Health Fitness, Education, News, or no selection.
- Style Filter avatars by style: Professional, Social, or no selection.

Output

The node outputs an array of JSON objects representing avatars that match the specified filters. Each object contains metadata about an avatar, such as its attributes and possibly URLs or identifiers needed to retrieve or display the avatar.

If the node supports binary data output (not explicitly shown in the provided code), it would typically include avatar image or video files in binary form. However, based on the static analysis, the output primarily consists of JSON data describing the avatars.

Dependencies

  • Requires an active connection to the JoggAI API.
  • The node needs an API authentication token or key configured in n8n credentials to authorize requests.
  • No additional external dependencies are indicated beyond the bundled modules and the JoggAI API.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid filter values may result in empty results or API errors.
    • Network connectivity issues can prevent successful API calls.

  • Error Messages:

    • Errors thrown during execution are logged with a prefix indicating failure in the JoggAI node.
    • If continueOnFail is enabled, errors for individual items do not stop the entire workflow but return error details per item.
    • To resolve errors, verify API credentials, ensure valid filter parameters, and check network status.

Links and References

Discussion