Actions132
- AI Actions
- Extract Text From Document
- Check Content Policy
- Detect Adult Content
- Detect Brand
- Detect Color
- Detect Email Type
- Detect Faces
- Extract Entities
- Extract Contact Information
- Extract Customizable Information From Text
- Fuzzy Text Matcher
- Generate Image
- Generate JavaScript Code
- Generate Python Code
- Detect Language
- Detect Mood
- Extract Text From PDF
- Recognize Objects in Image
- Extract Text From Image
- Redact Sensitive Information From PDF
- Remove Background Image
- Summarize Text
- Transcribe
- Translate Text
- Image Actions
- Business Actions
- Convert Actions
- Generate Actions
- Crypto Actions
- Operator Actions
- Storage Actions
- Scheduler Actions
- Text Actions
- Chart Actions
- Code Actions
- Calculate Actions
- Date and Time Actions
- PDF Actions
- Compress PDF File
- Count PDF Pages
- Create Empty PDF
- Decrypt PDF
- Convert DOCX to PDF
- Draw Image on PDF
- Draw Text on PDF
- Encrypt PDF
- Convert HTML to PDF
- Convert Markdown to PDF
- Manage PDF Metadata
- Merge PDF Files
- Add PDF Pages
- Remove PDF Pages
- Resize PDF Pages
- Rotate PDF Pages
- Convert PDF to Base64
- Convert PDF to Image
- Split PDF File
- Add Image Watermark to PDF
- Add Text Watermark to PDF
- Shortened URL Actions
Image → Overlay Images
AI-generatedOverview
The node provides an image processing utility specifically for overlaying one image on top of another. It supports two data input types: URLs pointing to images or base64-encoded image buffers. Users can specify the position (X and Y coordinates) where the overlay image should be placed on the base image.
This node is beneficial in scenarios such as:
- Adding watermarks or logos onto photos.
- Creating composite images by layering graphics.
- Annotating images with icons or badges dynamically.
For example, a marketing automation workflow could use this node to add a company logo overlay to product images before publishing them online.
Properties
| Name | Meaning |
|---|---|
| Data Type | Choose the source type of the images: either "URL" (image accessible via web URL) or "Buffer" (base64-encoded image data). |
| Base Image URL | The URL of the base image onto which the overlay will be applied (required if Data Type is URL). |
| Base Image Buffer | The base64-encoded string representing the base image (required if Data Type is Buffer). |
| Overlay Image URL | The URL of the overlay image to place on top of the base image (required if Data Type is URL). |
| Overlay Image Buffer | The base64-encoded string representing the overlay image (required if Data Type is Buffer). |
| X Position | Horizontal pixel coordinate specifying where to place the overlay image relative to the base image's left edge. Default is 0. |
| Y Position | Vertical pixel coordinate specifying where to place the overlay image relative to the base image's top edge. Default is 0. |
Output
The node outputs a JSON object containing the resulting image after applying the overlay. The output image is typically encoded in a format suitable for further processing or saving, such as a base64-encoded string or a URL to the processed image (depending on the underlying service response).
If binary data is included, it represents the final composited image file.
Dependencies
- Requires an API key credential for authentication with the external image processing service at
https://prod.0codekit.com. - The node sends a POST request to the
/image/overlayendpoint of this service with the provided parameters. - Proper network access to the URLs specified for the base and overlay images is necessary if using URL inputs.
Troubleshooting
- Invalid Image Data: If the base or overlay image URLs are inaccessible or the base64 strings are malformed, the node may fail. Ensure URLs are reachable and base64 data is correctly formatted.
- Positioning Issues: Incorrect X or Y values might cause the overlay to appear outside the visible area. Use sensible pixel values within the dimensions of the base image.
- Authentication Errors: Missing or invalid API credentials will prevent the node from functioning. Verify that the API key is correctly configured in n8n credentials.
- Unsupported Image Formats: The external service may not support all image formats. Use common formats like JPEG or PNG.
- Timeouts or Network Errors: Large images or slow networks might cause timeouts. Optimize image sizes or check connectivity.
Links and References
- 0CodeKit API Documentation (for detailed API usage and image overlay endpoint)
- Base64 Image Encoding Guide