This guide shows how to upscale images using the Pro Upscaler Creative model via the Leonardo.AI REST API.

To learn about the benefits and best practices of this upscaler, please refer to this blog.

Sample Request

curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \
     --header 'authorization: Bearer {api-key}' \
     --header 'Content-Type: application/json' \
     --data '{
       "model": "aurora-upscaler-creative",
       "public": false,
       "parameters": {
         "height": 848,
         "width": 1264,
         "upscale_factor": 2,
         "creativity": "low",
         "guidances": {
           "image_reference": [
             {
               "image": {
                 "id": "f823926a-ce29-4680-a599-e8af39db91b1",
                 "type": "GENERATED"
               }
             }
           ]
         }
       }
     }'

Recipes

API Request Endpoint, Headers, Parameters

Endpoint

https://cloud.leonardo.ai/api/rest/v2/generations

Headers

--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"

Body Parameters

Parameter	Type	Definition
height	`integer`	Required. Height of input image in pixels.
model	`string`	Required. Set to `aurora-upscaler-precise`.
parameters.upscale_factor	`integer`	Required. Controls Upscale Multiplier. Set to `2`, `3`, `4`, `5`, `6`, or `8`.
parameters.creativity	`string`	Required. Controls Creativity Strength. Set to `low` for Subtle, `mid` for Balanced, or `high` for Strong.
parameters.guidances.image_reference	`array`	Required. Array of 1 image to upscale. Each each image specifies an image.id and an image.type (`GENERATED` or `UPLOADED` or `VARIATION`).
public	`boolean`	Optional. Set to `false` to keep result private.
width	`integer`	Required. Width of input image in pixels.