Overview
This node integrates with the Robolly service to generate images based on predefined templates. It allows users to select an image template, customize elements within that template, and specify output formats and quality settings. The node is useful for automating the creation of customized images such as marketing materials, social media posts, or any scenario where templated image generation is needed.
Practical examples:
- Automatically generating personalized promotional banners by filling in text or images in a template.
- Creating product images with dynamic overlays or labels.
- Generating social media graphics with user-specific data.
Properties
| Name | Meaning |
|---|---|
| Image Template Name or ID | Select an existing image template from Robolly or specify its ID via expression. This defines the base design for the generated image. |
| Image Format | Choose the output image format: JPG (1 credit per image) or PNG (3 credits per image). |
| Change Encoding | Optionally convert the generated image to another format such as AVIF, RAW, TIFF, or WebP for different compression or quality characteristics. "None" means no conversion. |
| Image Scale | Adjust the scale of the generated image relative to the template size: Default (1x), Low Quality (0.5x), High Quality (2x), or Super High Quality (3x). |
| Change File Extension | When converting image encoding, optionally change the file extension to PNG or JPG, or keep it the same as the chosen encoding. |
| Template Elements | Modify specific elements within the selected template by specifying element names or IDs and their new values. Multiple elements can be updated in one execution. |
| ⚡ Generate Link Only ⚡ | If enabled, the node returns only a render link to the generated image instead of the image data itself. |
| Hidden Render Link | If enabled, the render link is encoded in Base64 to create a hidden link, which may be used for embedding or obfuscation purposes. |
Output
The node outputs JSON data containing either:
- The generated image data (likely as a URL or binary data reference).
- Or, if "Generate Link Only" is enabled, a direct render link to the image.
If binary data is included, it represents the generated image file in the specified format and encoding.
Dependencies
- Requires an API key credential for authenticating with the Robolly service.
- Needs access to Robolly's API endpoints to fetch templates, elements, and generate images.
- No additional environment variables are explicitly required beyond the API authentication.
Troubleshooting
- Invalid Template ID or Name: If the selected template does not exist or the ID is incorrect, the node will fail to generate an image. Verify template availability in Robolly.
- Insufficient Credits: Choosing PNG format consumes more credits; ensure your Robolly account has enough credits.
- Unsupported Element Names: Modifying elements with invalid names or IDs will cause errors. Use the provided load options to select valid elements.
- Conversion Errors: Selecting incompatible encoding conversions or extensions might result in failures. Use supported combinations only.
- API Authentication Failures: Ensure the API key credential is correctly configured and has necessary permissions.
Links and References
- Robolly Documentation (hypothetical, replace with actual)
- n8n Expressions Documentation - for using expressions in property fields