Start Creative Upscale

POST

https://api.ezlinkai.com/v2beta/stable-image/upscale/creative

Upscale

Takes images between 64x64 and 1 megapixel and upscales them all the way to 4K resolution. Put more
generally, it can upscale images ~20-40x times while preserving, and often enhancing, quality.
Creative Upscale works best on highly degraded images and is not for photos of 1mp or above as it performs
heavy reimagining (controlled by creativity scale).

Try it out

Grab your API key and head over to

How to use

Please invoke this endpoint with a POST request.

The headers of the request must include an API key in the authorization field. The body of the request must be
multipart/form-data.

The body of the request should include:

image

prompt

The body may optionally include:

seed

negative_prompt

output_format

creativity

Note: for more details about these parameters please see the request schema below.

After invoking this endpoint with the required parameters, use the id in the response to poll for results at the
upscale/result/{id} endpoint. Rate-limiting or other errors may occur if you poll more than once every 10 seconds.

Credits

Flat rate of 25 credits per successful generation. You will not be charged for failed generations.

Request

Header Params

authorization

string

required

Your Stability API key, used to authenticate your requests. Although you may have multiple keys in your account, you should use the same key for all requests to this API.

>= 1 characters

content-type

string

required

The content type of the request body. Do not manually specify this header; your HTTP client library will automatically include the appropriate boundary parameter.

>= 1 characters

Example:

multipart/form-data

stability-client-id

string

optional

The name of your application, used to help us communicate app-specific debugging or moderation issues to you.

<= 256 characters

Example:

my-awesome-app

stability-client-user-id

string

optional

A unique identifier for your end user. Used to help us communicate user-specific debugging or moderation issues to you. Feel free to obfuscate this value to protect user privacy.

<= 256 characters

Example:

DiscordUser#9999

stability-client-version

string

optional

The version of your application, used to help us communicate version-specific debugging or moderation issues to you.

<= 256 characters

Example:

1.2.1

Body Params multipart/form-data

image

file

required

The image you wish to upscale.

Supported Formats:

jpeg

png

webp

Validation Rules:

Every side must be at least 64 pixels

Total pixel count must be between 4,096 and 1,048,576 pixels

Example:

./some/image.png

prompt

string

required

What you wish to see in the output image. A strong, descriptive prompt that clearly defines
elements, colors, and subjects will lead to better results.

To control the weight of a given word use the format (word:weight),
where word is the word you'd like to control the weight of and weight
is a value between 0 and 1. For example: The sky was a crisp (blue:0.3) and (green:0.8)
would convey a sky that was blue and green, but more green than blue.

>= 1 characters<= 10000 characters

negative_prompt

string

optional

A blurb of text describing what you do not wish to see in the output image.
This is an advanced feature.

<= 10000 characters

output_format

enum<string>

optional

Dictates the content-type of the generated image.

Allowed values:

jpegpngwebp

Default:

png

Example:

png

seed

number

optional

A specific value that is used to guide the 'randomness' of the generation. (Omit this parameter or pass 0 to use a random seed.)

>= 0<= 4294967294

Default:

creativity

number

optional

Indicates how creative the model should be when upscaling an image.
Higher values will result in more details being added to the image during upscaling.

>= 0<= 0.35

Default:

0.3

Example:

0.3

Request samples

Python

JavaScript

Shell

Java

Swift

PHP

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.ezlinkai.com/v2beta/stable-image/upscale/creative' \
--header 'authorization;' \
--header 'stability-client-id;' \
--header 'stability-client-user-id;' \
--header 'stability-client-version;' \
--form 'image=@"./some/image.png"' \
--form 'prompt=""' \
--form 'negative_prompt=""' \
--form 'output_format="png"' \
--form 'seed=""' \
--form 'creativity="0.3"'

Responses

🟢200Upscale was started.

application/json

Body

string

required

The id of a generation, typically used for async generations, that can be used to check the status of the generation or retrieve the result.

>= 64 characters<= 64 characters

Example:

a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4

Example

{
    "id": "a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4"
}

🟠400Invalid parameter(s), see the `errors` field for details.

🟠403Your request was flagged by our content moderation system.

🟠413Your request was larger than 10MiB.

🟠422Your request was well-formed, but rejected. See the `errors` field for details.

🟠429You have made more than 150 requests in 10 seconds.

🔴500An internal error occurred. If the problem persists [contact support](https://stabilityplatform.freshdesk.com/support/tickets/new).

Modified at 2024-08-18 02:36:37

Conservative

Fetch Creative Upscale result

Start Creative Upscale

Try it out#

How to use#

Credits#

Request

Request samples

Responses

Try it out

How to use

Credits