import requests

generation_id = "e52772ac75b..."

response = requests.request(
    "GET",
    f"https://api.stability.ai/v2alpha/generation/stable-image/upscale/result/{generation_id}",
    headers={
        'Accept': "image/*",  # Use 'application/json' to receive base64 encoded JSON
        'authorization': f"Bearer sk-MYAPIKEY"
    },
)

if response.status_code == 202:
    print("Generation in-progress, try again in 10 seconds.")
elif response.status_code == 200:
    print("Generation complete!")
    with open("upscaled.webp", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))

"The bytes of the generated jpeg"

{
  "id": "a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4",
  "status": "in-progress"
}

{
  "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "bad_request",
  "errors": [
    "some-field: is required"
  ]
}

{
  "id": "ed14db44362126aab3cbd25cca51ffe3",
  "name": "content_moderation",
  "errors": [
    "Your request was flagged by our content moderation system, as a result your request was denied and you were not charged."
  ]
}

{
  "id": "2bca35116bc5431d6dc4b4ea2ef3da2f",
  "name": "generation_not_found",
  "errors": [
    "id: the generation either does not exist or has expired."
  ]
}

{
  "id": "2a1b2d4eafe2bc6ab4cd4d5c6133f513",
  "name": "internal_error",
  "errors": [
    "An unexpected server error has occurred, please try again later."
  ]
}

v2alpha/generation

stable-image/upscale/result

Fetch the result of an upscale generation by ID. Make sure to use the same API key to fetch the generation result that you used to create the generation, otherwise you will receive a 404 response.

How is progress reported?

Your generation is either in-progress (i.e. status code 202) or it is complete (i.e. status code 200). We may add more fine-grained progress reporting in the future (e.g. a numerical progress).

How long are results stored?

Results are stored for 24 hours after generation. After that, the results are deleted.

GET

v2alpha

generation

stable-image

upscale

result

{id}

import requests

generation_id = "e52772ac75b..."

response = requests.request(
    "GET",
    f"https://api.stability.ai/v2alpha/generation/stable-image/upscale/result/{generation_id}",
    headers={
        'Accept': "image/*",  # Use 'application/json' to receive base64 encoded JSON
        'authorization': f"Bearer sk-MYAPIKEY"
    },
)

if response.status_code == 202:
    print("Generation in-progress, try again in 10 seconds.")
elif response.status_code == 200:
    print("Generation complete!")
    with open("upscaled.webp", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))

"The bytes of the generated jpeg"

{
  "id": "a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4",
  "status": "in-progress"
}

{
  "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "bad_request",
  "errors": [
    "some-field: is required"
  ]
}

{
  "id": "ed14db44362126aab3cbd25cca51ffe3",
  "name": "content_moderation",
  "errors": [
    "Your request was flagged by our content moderation system, as a result your request was denied and you were not charged."
  ]
}

{
  "id": "2bca35116bc5431d6dc4b4ea2ef3da2f",
  "name": "generation_not_found",
  "errors": [
    "id: the generation either does not exist or has expired."
  ]
}

{
  "id": "2a1b2d4eafe2bc6ab4cd4d5c6133f513",
  "name": "internal_error",
  "errors": [
    "An unexpected server error has occurred, please try again later."
  ]
}

Authorizations

authorization

string

header

required

Use your Stability API key to authentication requests to this App.

Headers

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.

Minimum string length: 1

enum<string>

default:image/*

Specify image/* to get the image bytes directly. Otherwise specify application/json to receive the image as base64 encoded JSON.

Available options:

image/*,

application/json

Path Parameters

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.

Required string length: 64

Example:

"a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4"

Response

The upscale was successful.

The bytes of the generated image.

The finish-reason and seed will be present as headers.