ilyworks

n8n community node for the Ilyworks image & video transformation API

Package Information

Downloads: 0 weekly / 49 monthly
Latest Version: 0.4.1
Author: Ilyworks

Available Nodes

Ilyworks icon
Ilyworks
Transform images and video with the Ilyworks media API

Documentation

n8n-nodes-ilyworks

An n8n community node for Ilyworks — a free, EU-hosted image and video transformation API.

Transform images, transcode videos, export for social platforms, and extract thumbnails — all from your n8n workflows, no infrastructure needed.

Installation

In your n8n instance:

  1. Go to Settings → Community Nodes
  2. Click Install
  3. Enter n8n-nodes-ilyworks
  4. Click Install

Credentials

  1. Get a free API key at api.ilyworks.nl
  2. In n8n, go to Credentials → New → Ilyworks API
  3. Paste your API key
  4. The Base URL defaults to https://api.ilyworks.nl — leave it unless you self-host

Resources & Operations

Image

Operation Description
Transform URL Fetch an image from a URL, apply transformations, get back binary or a URL
Upload & Transform Upload a binary image from your workflow and transform it
Get Info Get metadata (width, height, format, file size) for any image URL

Video

Operation Description
Transcode Convert, resize, trim, or change format of a video
Platform Export Re-encode a video optimised for TikTok, Instagram Reels, YouTube, Instagram, or Twitter
Extract Thumbnail Pull a single frame from a video as a JPEG, PNG, or WebP image

Job

Video operations are async — they return a jobId. Use these to handle the result:

Operation Description
Get Status Check the current status and progress of a video job
Wait Until Done Poll automatically until the job completes, then continue the workflow
Download Result Download the finished video as a binary file

Usage Examples

Resize & convert an image to WebP

  1. Add an Ilyworks node
  2. Resource: Image → Operation: Transform URL
  3. Set Image URL to your source image
  4. Set Width to 800, Format to WebP
  5. Set Return As to Binary (Image File)

The output binary can be passed directly to a subsequent node (e.g. write to disk, upload to S3, send via email).

Export a video for TikTok

  1. Add an Ilyworks node
  2. Resource: Video → Operation: Platform Export
  3. Set Video URL to your source video
  4. Set Platform to TikTok — 1080×1920 (9:16)
  5. Connect a second Ilyworks node:
    • Resource: Job → Operation: Wait Until Done
    • Set Job ID to {{ $json.jobId }}
  6. Connect a third Ilyworks node:
    • Resource: Job → Operation: Download Result
    • Set Job ID to {{ $json.jobId }}

The final node outputs the re-encoded video as a binary ready for upload.

Extract a thumbnail from a video

  1. Add an Ilyworks node
  2. Resource: Video → Operation: Extract Thumbnail
  3. Set Video URL to your source video
  4. Set Timestamp (Seconds) to e.g. 5 to grab the frame at 5 seconds
  5. Set Thumbnail Format to JPEG

Returns a job — follow the same Job → Wait → Download pattern above.

Image Transform Options

All options are available under Additional Options in the image operations:

Option Description
Width / Height Output dimensions in pixels
Format WebP (default), AVIF, JPEG, PNG, GIF
Fit How to fit into dimensions: Cover, Contain, Fill, Inside, Outside
Quality 1–100 (default 80)
Blur Gaussian blur sigma (0.3–1000)
Sharpen Sharpen amount
Grayscale Convert to black & white
Sepia Apply sepia tone
Negate Invert colors
Flip / Flop Mirror vertically / horizontally
Rotate Rotate by degrees
Brightness / Contrast / Saturation / Hue Adjust colour properties
Watermark Text Overlay text on the image
Watermark Position Where to place the watermark
Padding Add transparent padding in pixels
Border Width / Color Add a solid border
Corner Radius Round corners (WebP/PNG only)
Background Color Fill transparent areas
Auto-Trim Whitespace Crop edges of uniform color

Video Transcode Options

Option Description
Width / Height Output dimensions in pixels
Format MP4 (default) or WebM
Framerate Output FPS
Trim Start / End Cut the video to a time range (seconds)
Quality CRF 0–51, lower = better quality (default 23)
Include Audio Keep or strip audio track
Strip Metadata Remove all metadata from the file (default on)

Self-Hosting

Ilyworks is open source. If you run your own instance, set the Base URL in your credentials to your own server URL (e.g. https://media.yourdomain.com).

Source code: github.com/Linuxifyy/ilyworks-media-api

Links

Discussion