Skip to main content

Create Upscale

Creates an upscaled version of a generated image with enhanced resolution and detail.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs​

  • Connection Id (String) - Connection ID from the Connect node (optional if API Key credentials are provided directly).
  • Generation Id (String) - ID of the generation containing the image to upscale (from Create Generation node).

Options​

  • API Key - Leonardo AI API key (optional if using Connection ID).

Outputs​

  • Variation Id (String) - ID of the upscale variation job. Use with Get Variation to retrieve the upscaled image.

How It Works​

The Create Upscale node initiates an upscaling job. When executed, the node:

  1. Validates the generation ID is not empty
  2. Sends an upscale request to Leonardo AI API
  3. Starts the upscaling process
  4. Returns a variation ID for tracking and retrieval

Requirements​

  • Valid Leonardo AI API key (via Connection ID or credentials)
  • Valid generation ID from a completed generation
  • The generation must contain at least one image
  • Sufficient API credits for upscaling

Error Handling​

The node will return specific errors in the following cases:

  • Empty generation ID - "Generation ID cannot be empty. Please provide the ID of the generation to upscale."
  • API error - "Failed to create upscale. API error {status}: {details}"
  • Runtime error - "Failed to create upscale: {details}. Please verify the generation ID and try again."

Usage Examples​

Basic Upscale Workflow​

Upscale a generated image:

  1. Create Generation with desired prompt
  2. Get Generation to check completion
  3. Extract the generation ID
  4. Create Upscale with the generation ID
  5. Use Get Variation to retrieve the upscaled image

Upscale Best Result​

Generate multiple images and upscale the best one:

  1. Create Generation with Number Of Images: 4
  2. Get Generation to retrieve all images
  3. Review images and select the best
  4. Create Upscale using the generation ID
  5. Get Variation to download high-resolution version

Automated Upscaling​

Automatically upscale all generations:

// After creating and completing generation
const generationId = $.generation_id;

// Create upscale
// Store variation ID
const variationId = $.variation_id;

// Wait a few seconds
// Get Variation to retrieve upscaled image

Upscale for Print​

Prepare images for high-resolution use:

  1. Generate image at standard resolution
  2. Verify the image meets your requirements
  3. Create Upscale for print-quality resolution
  4. Get Variation and download the high-res image
  5. Use for printing or detailed work

Batch Upscale Generations​

Upscale multiple generations:

const generationIds = [
  'gen-id-1',
  'gen-id-2',
  'gen-id-3'
];

const variationIds = [];

generationIds.forEach(genId => {
  // Create Upscale for each
  // Store variation IDs
});

// Later, retrieve all upscaled images

Usage Notes​

  • Upscaling is asynchronous - use Get Variation to check status and retrieve results
  • The process typically takes 10-30 seconds
  • Upscaled images have significantly higher resolution
  • Upscaling consumes API credits
  • Can only upscale images from your own generations
  • The generation must be complete before upscaling
  • Enhanced detail and sharpness in the upscaled version
  • Use for final outputs, prints, or detailed work
  • The variation ID is different from the generation ID
  • Original generation remains unchanged
  • Upscaling works best with good quality initial generations
  • May not improve images that are already low quality or blurry
  • Consider upscaling only your final selected images to save credits
  • Multiple images in a generation will all be upscaled