IlyworksInstall

Summary

Transform an image from a URL by applying various image transformations and return either the transformed image as binary data or a URL to the transformed image.

Inputs

• Image URL (required) — URL of the source image to transform.
• Width — Output image width in pixels; 0 keeps the original width.
• Height — Output image height in pixels; 0 keeps the original height.
• Format — Output image format: AVIF, GIF, JPEG, PNG, or WebP (default).
• Fit — How the image should fit the given dimensions: Attention (smart crop), Contain, Cover (default), Entropy (smart crop), Face (face-centred crop), Fill, Inside, or Outside.
• Quality — Output quality from 1 to 100.
• Additional Options — Various optional image modifications including auto-trim whitespace, background color, blur, border color/width, brightness, contrast, corner radius (PNG/WebP only), flip/flop, grayscale, hue adjustment, negate, padding, rotation, saturation, sepia, sharpen, tint, watermark text and position.
• Return As — Choose to return the transformed image as a binary file or as a URL string.

Output shape

a single item per input containing either binary image data with appropriate filename and MIME type if 'Return As' is binary, or JSON containing the transformed image URL if 'Return As' is URL string.

If 'Return As' is binary, the node performs a GET request to fetch the transformed image and returns it in binary form. If set to URL, it constructs and returns the transformed image URL without fetching image data.

Examples

Example 1: Resize an image to 400x300 pixels, convert to JPEG format, and get the transformed image as binary data.

Set Image URL to source image URL; Width to 400; Height to 300; Format to JPEG; Return As to Binary (Image File).

Example 2: Generate a URL for a WebP version of an image with smart crop on the face and quality 90.

Set Image URL to source image URL; Format to WebP; Fit to Face; Quality to 90; Return As to URL String.

Links

• n8n community nodes installation guide