Overview
The GenerateBanners node for n8n allows users to generate images using the GenerateBanners API based on a selected template and dynamic variables. This is particularly useful for automating the creation of marketing banners, social media graphics, or any visual content that relies on templates with variable data.
Common scenarios:
- Automatically generating personalized banners for email campaigns.
- Creating dynamic social media posts with user-specific information.
- Batch-generating product images with different prices, names, or other attributes.
Practical example:
A marketing team can use this node to create hundreds of banner variations by specifying a template ID and providing different sets of variables (like product name, price, and image) for each item in their campaign.
Properties
| Name | Type | Meaning |
|---|---|---|
| Template ID | String | The unique identifier of the template you want to use for image generation. You can find this in your GenerateBanners account under your template list. |
| Variables | Collection | A set of key-value pairs where each "Name" is a variable defined in the template, and "Value" is the value to substitute. Multiple variables can be provided to customize the generated image. |
Output
The node returns a JSON object (or an array of objects) containing the result from the GenerateBanners API. The structure typically includes:
{
"signUrl": "https://api.generatebanners.com/your-generated-image-url"
}
signUrl: A signed URL pointing to the generated image, which can be accessed or downloaded.
Note: If the API response contains additional fields, they will also be included in the output.
Dependencies
- External Service: Requires access to the GenerateBanners API.
- API Key: You must configure the
generateBannersApicredential in n8n with your API key from GenerateBanners.
Troubleshooting
Common issues:
- Invalid Template ID: If the provided Template ID does not exist or is incorrect, the API may return an error. Double-check the Template ID from your GenerateBanners dashboard.
- Missing Variables: If required variables are not provided or are misspelled, the generated image may not render as expected or the API may throw an error.
- Authentication Errors: If the API key is missing or invalid, authentication errors will occur. Ensure your credentials are correctly set up in n8n.
Error messages and resolutions:
"Template not found": Verify the Template ID."Missing required variable": Check that all required variables for the template are supplied."Unauthorized": Ensure your API key is valid and has sufficient permissions.