Overview
This node integrates with Venice.ai to generate and manipulate images using AI. Specifically, the Upscale operation allows users to enhance or enlarge an existing image by providing either a base64-encoded image or a URL. The node sends the image along with scaling and enhancement options to Venice.ai's API, which returns an upscaled version of the image.
Typical use cases include:
- Improving the resolution of low-quality images for printing or display.
- Enhancing details in photographs or artwork.
- Applying creative enhancements or styles during upscaling.
For example, a user might provide a small photo and request it to be doubled in size (scale factor 2) while applying a "gold" style enhancement to give it a unique artistic look.
Properties
| Name | Meaning |
|---|---|
| Image | Base64-encoded image data or a URL pointing to the image to be upscaled. |
| Scale | The factor by which to upscale the image; must be between 1 and 4. |
| Upscale Options | Collection of optional parameters: • Enhance: Whether to apply enhancement during upscaling (true/false). • Enhance Creativity: A number from 0 to 1 indicating how creative the AI should be when enhancing. • Enhance Prompt: A style description string to apply during enhancement (e.g., "gold", "marble"). • Replication: A number from 0 to 1 controlling how strongly lines and noise from the original image are preserved. |
Output
The node outputs an array of items, each containing:
jsonobject with metadata about the upscaled image:success: Boolean indicating if the operation succeeded.fileName: Generated filename for the upscaled image (e.g.,"venice_upscaled_1680000000000.png").fileExtension: File extension based on the returned image format (png,jpg, orwebp).contentType: MIME type of the returned image (e.g.,"image/png").size: Size in bytes of the binary image data.scale: The scale factor used for upscaling.
binarydata containing the actual upscaled image file, ready for further processing or saving.
Dependencies
- Requires an API key credential for Venice.ai to authenticate requests.
- The node makes HTTP POST requests to Venice.ai endpoints:
/image/upscalefor the upscale operation.
- n8n environment must have internet access to reach
https://api.venice.ai/api/v1. - No additional external dependencies beyond the configured API credential.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Providing an invalid image string or URL may result in errors from the API.
- Scale values outside the allowed range (1-4) will likely cause validation errors.
- Network connectivity problems can prevent successful API calls.
Error messages:
- Errors thrown by the API will be caught and returned as JSON error messages if "Continue On Fail" is enabled.
- Typical error messages may include "Invalid image format," "Authentication failed," or "Scale value out of range."
Resolutions:
- Verify that the API key credential is correctly set up and valid.
- Ensure the input image is properly encoded or accessible via URL.
- Use scale values within the allowed range.
- Check network connectivity and firewall settings.
Links and References
- Venice.ai Documentation (for API details and usage)
- n8n HTTP Request Node Documentation (for understanding HTTP request handling)
- Image Upscaling Concepts (general background on image upscaling)