Upscale

​

Overview

The AI Subnet’s upscale pipeline provides advanced image upscaling. Powered by the latest diffusion models in HuggingFace’s super-resolution pipeline, it enhances the resolution of input images by a factor of 4.

​

Models

​

Warm Models

The current warm model requested for the upscale pipeline is:

• stabilityai/stable-diffusion-x4-upscaler: A text-guided upscaling diffusion model trained on large LAION images, offering enhanced resolution and controlled noise addition.

​

On-Demand Models

The following models have been tested and verified for the upscale pipeline:

​

Basic Usage Instructions

To generate an image with the upscale pipeline, send a POST request to the Gateway’s upscale API endpoint:

curl -X POST https://<gateway-ip>/upscale \
    -F model_id="stabilityai/stable-diffusion-x4-upscaler" \
    -F image=@<PATH_TO_IMAGE>/low_res_cat.png \
    -F prompt="A white cat"

In this command:

• <gateway-ip> should be replaced with your AI Gateway’s IP address.
• model_id is the diffusion model for image generation.
• The image field holds the absolute path to the image file to be upscaled.
• prompt is a descriptive text that provides context about the content of the image.

For additional optional parameters, refer to the AI Subnet API Reference.

After execution, the Orchestrator processes the request and returns the response to the Gateway:

{
  "images": [
    {
      "nsfw": false,
      "seed": 3197613440,
      "url": "https://<gateway-ip>/stream/dd5ad78d/7adde483.png"
    }
  ]
}

The url in the response is the URL of the generated image. Download the image with:

curl -O "https://<STORAGE_ENDPOINT>/stream/dd5ad78d/7adde483.png"

​

API Reference