# Magic Upscale

**Action ID:** `magic_upscale`

## Description

Upscale and enhance image quality using AI-powered technology. This node uses PixelML's advanced upscaling algorithms to increase image resolution while preserving or improving visual quality.

## Provider

**PixelML**

## Connection

| Name               | Description                                 | Required | Category  |
| ------------------ | ------------------------------------------- | :------: | --------- |
| PixelML Connection | The PixelML connection to call PixelML API. |     ✓    | pixel\_ml |

## Input Parameters

| Name       | Type   | Required | Default | Description                                                          |
| ---------- | ------ | :------: | ------- | -------------------------------------------------------------------- |
| image\_url | string |     ✓    | -       | URL of the image to upscale. Supported formats: PNG, JPEG, JPG, WEBP |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Comfy UI node input.",
  "properties": {
    "image_url": {
      "description": "URL of the image to upscale",
      "title": "Image url",
      "type": "string",
      "json_schema_extra": {}
    }
  },
  "required": [
    "image_url"
  ],
  "title": "MagicUpscaleNodeInput",
  "type": "object"
}
```

</details>

## Output Parameters

| Name  | Type   | Description                      |
| ----- | ------ | -------------------------------- |
| image | string | URL of the upscaled image output |

<details>

<summary>View JSON Schema</summary>

```json
{
  "description": "Comfy UI node output.",
  "properties": {
    "image": {
      "title": "Image output",
      "type": "string",
      "json_schema_extra": {}
    }
  },
  "required": [
    "image"
  ],
  "title": "MagicUpscaleNodeOutput",
  "type": "object"
}
```

</details>

## How It Works

This node sends your image to PixelML's upscaling service, which uses advanced AI algorithms to increase the image resolution while maintaining or enhancing visual quality. The service analyzes the image content and intelligently fills in additional pixels to create a larger, higher-resolution version. The upscaled image is then returned as a URL that you can use in subsequent nodes or download.

## Usage Examples

### Example 1: Upscale Product Image

**Input:**

```
image_url: "https://images.example.com/product_low_res.jpg"
```

**Output:**

```
image: "https://pixelml-output.example.com/upscaled_product_12345.png"
```

### Example 2: Enhance Photo for Print

**Input:**

```
image_url: "https://storage.example.com/photo_original.webp"
```

**Output:**

```
image: "https://pixelml-output.example.com/enhanced_photo_67890.png"
(2x upscaled version ready for high-quality printing)
```

### Example 3: Improve Low-Quality Screenshot

**Input:**

```
image_url: "https://cdn.example.com/screenshot_small.png"
```

**Output:**

```
image: "https://pixelml-output.example.com/upscaled_screenshot_11111.png"
(Clearer, sharper version suitable for documentation)
```

## Common Use Cases

* **Product Photography**: Upscale product images for e-commerce sites to showcase details
* **Print Media**: Enhance images for printing in catalogs, posters, or promotional materials
* **Archival Restoration**: Improve quality of old or low-resolution images
* **Screenshot Enhancement**: Make UI screenshots clearer and sharper for documentation
* **Social Media Optimization**: Prepare images for different platform requirements
* **AI Art Generation**: Post-process generated images to increase resolution
* **Video Frames**: Upscale individual frames extracted from low-resolution videos

## Error Handling

| Error Type            | Cause                                          | Solution                                                       |
| --------------------- | ---------------------------------------------- | -------------------------------------------------------------- |
| Invalid Image URL     | Image URL is malformed or inaccessible         | Verify the URL is valid and the image is publicly accessible   |
| Unsupported Format    | Image format is not PNG, JPEG, JPG, or WEBP    | Convert the image to a supported format before upscaling       |
| Corrupted Image       | Image file is corrupted or incomplete          | Try with a different or fresh copy of the image                |
| PixelML Service Error | PixelML API is unavailable or returning errors | Check your PixelML connection and try again later              |
| Authentication Error  | Invalid or expired PixelML credentials         | Verify your PixelML connection configuration                   |
| Rate Limit Exceeded   | Too many upscale requests in a short period    | Implement delays between requests or upgrade your PixelML plan |
| Timeout Error         | Request took too long to process               | Try with a smaller image or simpler content                    |

## Notes

* **Supported Formats**: PNG, JPEG, JPG, and WEBP images are supported
* **Image Size**: Very large images may take longer to process; consider splitting if needed
* **Quality Preservation**: The AI algorithm intelligently preserves image details while enhancing resolution
* **URL Requirements**: The image URL must be publicly accessible (not behind authentication)
* **Output Format**: Upscaled images are typically returned as PNG or JPEG URLs
* **Caching**: Upscale results may be cached; requesting the same image multiple times returns the same upscaled version
* **Best Results**: Works best with images that have clear subjects and reasonable original quality


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agenticflow.ai/reference/nodes/magic_upscale.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.