---
title: "image-to-image/upscale"
method: POST
path: "/generation/{engine_id}/image-to-image/upscale"
tags: ["v1/generation"]
---

# image-to-image/upscale

`POST /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.

## Path parameters

- `engine_id` string, required

## Headers

- `Accept` 'application/json' | 'image/png'
- `Organization` string

## Response `200`

OK response.

- Image[] — The result of the generation request, containing one or more images as base64 encoded strings.
  - `base64` string — Image encoded in base64
  - `finishReason` 'SUCCESS' | 'ERROR' | 'CONTENT_FILTERED'
  - `seed` number — The seed associated with this image

## Other responses

- `400` — bad_request: general error for invalid parameters <br/><br/> <p style="display: flex; margin-top: -20px; margin-bottom: 0">More specific errors:</p> - invalid_file_size: The file size of one or more of the provided files is invalid - invalid_mime_type: The mime type of one or more of the provided files is invalid - invalid_pixel_count: The requested image would exceed the maximum pixel count of 4,194,304
- `401` — unauthorized: API key missing or invalid
- `403` — permission_denied: You lack the necessary permissions to perform this action
- `404` — not_found: The requested resource was not found (e.g. specifing a model that does not exist)
- `500` — server_error: Some unexpected server error occurred

---

[API](https://skmtc.dev/stability-ai/apis/stability-ai-rest-api.md) · [All operations](https://skmtc.dev/stability-ai/apis/stability-ai-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stability-ai/stability-ai-rest-api/revisions/020f8f47c903/schema)