Actions9
Overview
The "Mallabe Images" node provides a set of image processing operations accessible via an API. Specifically, the Greyscale Image operation converts a given image to greyscale (black and white). This is useful for scenarios where you want to simplify images, reduce color complexity, or create stylistic effects in automated workflows.
Practical examples include:
- Automatically converting product photos to greyscale for catalog consistency.
- Preparing images for printing where color is not required.
- Creating artistic or vintage-style images in marketing automation.
The node accepts a public URL of the image to process and can either return a direct link to the processed image or download the image data into the workflow for further use.
Properties
| Name | Meaning |
|---|---|
| Image URL | Public URL of the image file to convert to greyscale. |
| Download Image? | Whether to download the processed image binary data into the workflow (true) or just return a link (false). |
| Put Output File In Field | When downloading, the name of the output field where the binary image data will be stored. |
| Webhook URL (Advanced) | Optional URL to send a webhook with the data of the operation after processing completes. |
Output
- If Download Image? is set to
false, the node outputs JSON containing at least aurlfield with the link to the greyscale image. - If Download Image? is
true, the node outputs JSON plus binary data under the specified output field name. The binary data contains the actual greyscale image file ready for downstream nodes that accept binary input (e.g., upload to storage, email attachments).
Example JSON output when not downloading:
{
"data": {
"url": "https://cdn.mallabe.com/processed/greyscale-image.jpg"
}
}
When downloading, the binary data will be available in the specified field, e.g., "data".
Dependencies
- Requires an active API key credential for the Mallabe Images service.
- The node makes HTTP POST requests to the Mallabe Images API endpoint
/v1/images/greyscale. - For downloading binary data, it fetches the image from the returned CDN URL.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
- Invalid Image URL: If the provided URL is not publicly accessible or not a valid image format, the API may reject the request or return an error. Ensure URLs are correct and publicly reachable.
- Protected URLs: Some integrations provide URLs that require authentication or are time-limited; these cannot be processed.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures.
- Download Failures: If downloading is enabled but the CDN URL is inaccessible, the node will fail to retrieve the binary data.
- Webhook URL Issues: If a webhook URL is provided but unreachable, the webhook call may fail silently or cause delays.
To resolve errors:
- Verify the image URL is correct and publicly accessible.
- Check API key validity and permissions.
- Disable download option to test if the issue is related to binary fetching.
- Remove or verify webhook URL correctness.
Links and References
- Mallabe Images API Documentation (hypothetical link)
- n8n documentation on working with binary data
- General info on image greyscale conversion