Stability.Ai
  1. generation
Stability.Ai
  • Getting Started
  • v1
    • user
      • account
      • balance
    • engines
      • list
    • generation
      • text-to-image
        POST
      • image-to-image
        POST
      • image-to-image/upscale
        POST
      • image-to-image/masking
        POST
  • v2alpha
    • generation
      • image-to-video
      • image-to-video/result
      • stable-image/upscale
      • stable-image/upscale/result
      • stable-image/inpaint
  • Schemas
    • Schemas
      • Engine
      • Error
      • CfgScale
      • ClipGuidancePreset
      • UpscaleImageHeight
      • UpscaleImageWidth
      • DiffuseImageHeight
      • DiffuseImageWidth
      • Sampler
      • Samples
      • Seed
      • Steps
      • Extras
      • StylePreset
      • TextPrompt
      • TextPrompts
      • TextPrompts
      • InputImage
      • InitImage
      • InitImageStrength
      • InitImageMode
      • StepScheduleStart
      • StepScheduleEnd
      • MaskImage
      • MaskSource
      • GenerationRequestOptionalParams
      • RealESRGANUpscaleRequestBody
      • LatentUpscalerUpscaleRequestBody
      • ImageToImageRequestBody
      • ImageToImageUsingImageStrengthRequestBody
      • ImageToImageUsingStepScheduleRequestBody
      • MaskingRequestBody
      • MaskingUsingMaskImageRequestBody
      • MaskingUsingInitImageAlphaRequestBody
      • TextToImageRequestBody
      • AccountResponseBody
      • BalanceResponseBody
      • ListEnginesResponseBody
      • FinishReason
      • Image
      • OrganizationMembership
      • GenerationID
      • ImageToVideoRequest
      • ContentModerationResponse
      • InpaintingSearchModeRequestBody
      • InpaintingMaskingModeRequestBody
    • Response
      • 401
      • 403
      • 404
      • 500
      • GenerationResponse
      • 400FromGeneration
      • 400FromUpscale
  1. generation

image-to-image/upscale

https://api.stability.ai
https://api.stability.ai
https://api.stability.ai
https://api.stability.ai
POST
/v1/generation/{engine_id}/image-to-image/upscale
Create a higher resolution version of an input image.
This operation outputs an image with a maximum pixel count of 4,194,304. This is equivalent to dimensions such as 2048x2048 and 4096x1024.
By default, the input image will be upscaled by a factor of 2. For additional control over the output dimensions, a width or height parameter may be specified.
For upscaler engines that are ESRGAN-based, refer to the RealESRGANUpscaleRequestBody body option below. For upscaler engines that are Stable Diffusion Latent Upscaler-based, refer to the LatentUpscalerUpscaleRequestBody body option below.
For more details on the upscaler engines, refer to the documentation on the Platform site.

Request

Path Params

Header Params

Body Params multipart/form-data

Responses

🟢200Success
application/json
Body

🟠400400
🟠401401
🟠403403
🟠404404
🔴500500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.stability.ai/v1/generation/esrgan-v1-x2plus/image-to-image/upscale'
Response Response Example
200 - Example 1
{
    "artifacts": [
        [
            {
                "base64": "...very long string...",
                "finishReason": "SUCCESS",
                "seed": 1050625087
            },
            {
                "base64": "...very long string...",
                "finishReason": "CONTENT_FILTERED",
                "seed": 1229191277
            }
        ]
    ]
}
Modified at 2024-03-11 07:12:09
Previous
image-to-image
Next
image-to-image/masking
Built with