# \[Preview] AI Upscale
{% hint style="warning" %}
Warning: AI Upscale is available as a preview feature.
As such, please be aware that there could be breaking changes with a 2-week notice period.
{% endhint %}
## Overview
The Image Editing API allows you to upscale an input image.
AI Upscale increases the resolution of your input image by 4.
For example, if you send an input image with resolution 300x400, then AI Upscale will turn it into an image of resolution 1200x1600.
{% hint style="info" %}
Please note that AI Upscale is currently limited to images with a maximum resolution of:
* 1,000x1,000 pixels for the mode `ai.fast`
* 512x512 for the mode `ai.slow`
{% endhint %}
Three upscale modes are available:
* Fast mode (classic)
* Fast mode (early access to new model using a header flag)
* Slow mode
In general, slow mode should produce results of a higher quality than fast mode.
However, we do recommend that you try all modes: for specific type of images, one might give better results than the other.
To upscale an image, set the argument `upscale.mode` to the value `ai.fast` or `ai.slow`.
To test the new `ai.fast` model, additionally set the HTTP header `pr-ai-upscale-model-version` to `ai-upscale-2025-07-29`:
(original image)
upscale.mode=ai.fast
upscale.mode=ai.slow
upscale.mode=ai.fast Early access to new model
If you want to give it a try, here are the code snippets to reproduce the examples above:
```bash
curl --request POST \
--url https://image-api.photoroom.com/v2/edit \
--header 'x-api-key: YOUR_API_KEY' \
--form 'imageFile=@"/path/to/image.jpeg"' \
--form 'referenceBox="originalImage"' \
--form 'removeBackground="false"' \
--form 'upscale.mode="ai.fast"' \
--output result-ai-fast.png
```
Try it now!
```bash
curl --request POST \
--url https://image-api.photoroom.com/v2/edit \
--header 'x-api-key: YOUR_API_KEY' \
--form 'imageFile=@"/path/to/image.jpeg"' \
--form 'referenceBox="originalImage"' \
--form 'removeBackground="false"' \
--form 'upscale.mode="ai.slow"' \
--output result-ai-slow.png
```
Try it now!
```bash
curl --request POST \
--url https://image-api.photoroom.com/v2/edit \
--header 'x-api-key: YOUR_API_KEY' \
--header 'pr-ai-upscale-model-version: ai-upscale-2025-07-29' \
--form 'imageFile=@"/path/to/image.jpeg"' \
--form 'referenceBox="originalImage"' \
--form 'removeBackground="false"' \
--form 'upscale.mode="ai.fast"' \
--output result-ai-fast.png
```
Try it now!
## Additional Examples
Below you can find some additional examples of using AI Upscale, with different type of images:
{% hint style="info" %}
Make sure to click on the images to see them in full resolution.
{% endhint %}
| *(original image)* | `upscale.mode=ai.fast` | `upscale.mode=ai.slow` |
|
## Advanced Upscaling Model
For the most demanding use cases, an advanced model is available for Enterprise plans:
(original image)
(advanced model output)
(original image)
(advanced model output)
(original image)
(advanced model output)
(original image)
(advanced model output)
(original image)
(advanced model output)
{% hint style="info" %}
Make sure to click on the images to see them in full resolution.
{% endhint %}
If you're interested to use this advanced model, please [contact our team to book a demo](https://www.photoroom.com/contact-sales?utm_source=apidocumentation\&utm_medium=enterprisegated).
Book a demo
