Mallabe Images icon

Mallabe Images

Mallabe Images is an automation toolchain that allows you to process images, resize, crop and apply other manipulations on images on the fly.

Actions9

Overview

The "Mallabe Images" node provides a set of image processing operations accessible via an API. Specifically, the Crop Image operation allows users to crop an image from a public URL based on specified dimensions and a pivot point (gravity). This is useful for automating image editing workflows such as preparing images for social media, thumbnails, or any scenario where precise cropping is needed without manual intervention.

For example, you can crop a product image to focus on the center area or crop from a specific corner using manual offsets. The node supports returning either a direct link to the cropped image or downloading the image data into the workflow for further use.

Properties

Name Meaning
Image URL Public URL of the image file to crop
Gravity Defines the pivot point from which to start cropping. Options: Manual, Center, Top, Left, Bottom, Right, Top-Left, Top-Right, Bottom-Left, Bottom-Right
Crop Width Width of the region to crop. Can be specified in pixels or percentage
Crop Height Height of the region to crop. Can be specified in pixels or percentage
Left (X Axis) Offset from the left edge; relevant only when Gravity is set to Manual
Top (Y Axis) Offset from the top edge; relevant only when Gravity is set to Manual
Download Image? Whether to download the cropped image binary data or just return a link to it
Put Output File In Field When downloading, the name of the output field to put the binary file data in
Webhook URL (Advanced) Optional URL to send a webhook with the data of the operation

Output

The node outputs JSON data containing details about the cropped image, including a URL to the processed image.

  • If Download Image? is set to false, the output JSON contains metadata and a URL pointing to the cropped image.
  • If Download Image? is set to true, the node downloads the cropped image binary data and places it in the specified output field (default "data"), alongside the JSON metadata.

This allows subsequent nodes in the workflow to either use the image URL or directly manipulate the binary image data.

Dependencies

  • Requires an active connection to the Mallabe Images API service.
  • An API key credential must be configured in n8n to authenticate requests.
  • The input image URL must be publicly accessible; protected URLs may not work.
  • Optional webhook URL can be provided to receive asynchronous notifications about the operation.

Troubleshooting

  • Invalid or inaccessible image URL: The node requires a publicly accessible image URL. Protected or invalid URLs will cause the operation to fail.
  • Unsupported image formats: Only common image formats like PNG, JPEG, GIF are supported. Other file types may not process correctly.
  • Incorrect gravity or offset values: When using manual gravity, ensure that X and Y offsets are within the bounds of the image dimensions.
  • API errors: Network issues or invalid API credentials will result in errors. Verify API key configuration and network connectivity.
  • Download failures: If downloading the image fails, check that the returned URL is valid and accessible.

Links and References

Discussion