AI Relight

Overview

The Image Editing API allows you to correct lighting issues, such as over-exposition or under-exposition, by re-lighting the input image.

To re-light an image, set the argument lighting.mode to either the value:

• ai.auto for the lighting to be automatically adjusted

• ai.preserve-hue-and-saturation for the lighting to be adjusted while keeping color hues and saturations as close as possible to the original image

  • this can be useful for product images, where maintaining color accuracy is important

Please note that AI Relight is currently limited to images with a maximum resolution of 3,500x3,500 pixels.

Known issue: we don't recommend using AI Relight along with AI Expand in a same API call.

Examples

Here are some examples of what re-lighting can achieve by setting lighting.mode=ai.auto:

Original	Re-lighted

If you want to give it a try, here's the code 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/your/image.jpg \
  --form referenceBox=originalImage \
  --form maxWidth=2000 \
  --form maxHeight=2000 \
  --form removeBackground=false \
  --form lighting.mode=ai.auto \
  --output with-re-lighting.png

And here are examples of the output produced by the different values for lighting.mode:

Second-hand marketplace

Original	lighting.mode=ai.auto	lighting.mode=ai.preserve-hue-and-saturation

School portraits

Original	lighting.mode=ai.auto	lighting.mode=ai.preserve-hue-and-saturation

Food industry

Original	lighting.mode=ai.auto	lighting.mode=ai.preserve-hue-and-saturation

Car industry

Original	lighting.mode=ai.auto	lighting.mode=ai.preserve-hue-and-saturation

Luxury industry

Original	lighting.mode=ai.auto	lighting.mode=ai.preserve-hue-and-saturation