---
title: "Upscale an image using ImageCon V3"
method: POST
path: "/api/ai/images/upscale/v3"
tags: ["AI Services"]
---

# Upscale an image using ImageCon V3

`POST /api/ai/images/upscale/v3`

## Request

- Base URL: `https://api.worqhat.com`
- URL: `https://api.worqhat.com/api/ai/images/upscale/v3`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/docs/api/ai/images/upscale/v3/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used to upscale an existing image using AI. It can take scale inputs of upto a combination of 4194304px. It accepts a Form Data containing the image modification parameters and returns the upscaled image.

## Request body `multi-part/form-data`

- object
  - `existing_image` string, binary: The image to be modified or edited. Keep in mind that the File Object dimensions should not exceed `1024x1024`. Also, the resulting image dimensions will not exceed `2048x2048`.
  - `output_type` 'url' | 'blob': The type of output to be generated. You can choose between `url` and `blob` . `URL` will return a cloud-hosted Temporary URL for the generated image, you need to handle the image download on your end. `blob` will return the image as a base64 encoded string.
  - `scale` number: The scale to be applied to the image. It is a number between 1 and maximum of 5. The higher the number, the more the image will be upscaled.

## Response `200`

Image generated successfully

- object
  - `status` string: Status indicating the success of the image generation.
  - `image` string: The generated image.
  - `processing_time` integer: The time taken to process the request, in milliseconds.
  - `processing_id` string: A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer: The number of times the request has been processed. This is what is considered in the Billing Process. This is either the number of times the image is processed or the number of words that the server processes.

## Other responses

- `400`: Bad Request. This mostly happens because of invalid image sizes. Valid dimensions are `1024x1024`, `1152x896`, `1216x832`, `1344x768`, `1536x640`, `640x1536`, `768x1344`, `832x1216`, `896x1152`.
- `401`: Unauthorized
- `404`: Not Found
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2023-11-03** `4dfb38675161`: 1 info
  - endpoint added
- **2023-10-20** `871850b7231f`: 1 breaking
  - api path removed without deprecation
- **2023-09-01** `7e5a49493623`: 1 warning, 1 info
  - removed the request property `baseFile`
  - added the new optional request property `existing_image`
- **2023-08-15** `b5ffe2a9748f`: 6 breaking, 17 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - …19 more
- **2023-08-04** `be85a8f8fc8c`: 6 breaking, 15 warning
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `404`
  - …17 more

[Operation history](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/changes/api/ai/images/upscale/v3/post.md)

---

[API](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2.md) - [All operations](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) - [OpenAPI document](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/revisions/fc369f69a3e6?raw)