Venice Image Generation icon

Venice Image Generation

Generate and manipulate images with Venice.ai

Actions2

Upscale

AI-generated

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:

  • json object 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, or webp).
    • 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.

  • binary data 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/upscale for 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

Discussion