[Preview] AI Upscale

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.

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.

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

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:

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!

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!

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:

Make sure to click on the images to see them in full resolution.

(original image)	upscale.mode=ai.fast	upscale.mode=ai.slow	upscale.mode=ai.fast Early access to new model

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)

Make sure to click on the images to see them in full resolution.

If you're interested to use this advanced model, please contact our team to book a demo.

Book a demo