> For the complete documentation index, see [llms.txt](https://docs.photoroom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.photoroom.com/image-editing-api-plus-plan/preview-ai-upscale.md).
# \[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
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.photoroom.com/image-editing-api-plus-plan/preview-ai-upscale.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.