Enhancing HDRs

Start by uploading your HDR brackets to the enhancement endpoint. To tell our system that you are uploading brackets, you need to set hdr: true in the body and explicitly provide an order_id

When uploading HDR brackets, you can't specify the enhancement options when uploading the images. These need to be defined when you merge the images.

HDR images require an order_id as we need to group all the images once they have been uploaded.

Create Image

POSThttps://api.autoenhance.ai/v3/images/

Authorization

ApiKeyAuth

Body

application/json

ratinginteger

A rating between 0 and 5 on how good the image enhancmeent. Higher is better.

ai_versionnullable enum

1.133.13.23.34null

enhance_typenullable enum

The type of enhancement to apply to the image. PROPERTY or PROPERTY_USA is used with AI version < 4.0, for >= 4.0 use WARM, NEUTRAL, or AUTHENTIC.

propertyproperty_usawarmneutralauthenticnull

sky_replacementboolean

Enable the replacement of the original sky for a summer sky.

vertical_correctionboolean

Correct any vertical distortion in the image so that it appears straight.

lens_correctionboolean

Correct any lens distortion in the image.

contrast_boostnullable enum

The amount of contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boostnullable enum

The amount of brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

saturation_levelnullable enum

The amount of saturation to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

sharpen_levelnullable enum

The amount of sharpening to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

denoise_levelnullable enum

The amount of denoising to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

clarity_levelnullable enum

The amount of clarity to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

privacyboolean

Whether to blur any faces or license plates in the image.

window_pullboolean

Whether to pull the windows in the image (used with AI version >= 4.0).

cloud_typenullable enum

The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD

CLEARLOW_CLOUDHIGH_CLOUDnull

sky_saturation_levelnullable enum

NONELOWMEDIUMHIGHnull

contrast_boost_internalnullable enum

The amount of internal contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

contrast_boost_externalnullable enum

The amount of external contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_internalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_externalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

image_name*string

order_idstring

content_typestring

The MIME type of the image i.e. image/jpeg, image/png, etc.

threesixtyboolean

Whether the image is a 360 image.

hdrboolean

Whether the image is a HDR bracket. An order_id must be provided when this is set to true.

Response

200401422

Successful response

Body

application/json

ai_versionnullable enum

1.133.13.23.34null

enhance_typenullable enum

The type of enhancement to apply to the image. PROPERTY or PROPERTY_USA is used with AI version < 4.0, for >= 4.0 use WARM, NEUTRAL, or AUTHENTIC.

propertyproperty_usawarmneutralauthenticnull

sky_replacementboolean

Whether the sky replacement feature was enabled for the image.

vertical_correctionboolean

Whether the vertical correction feature was enabled for the image.

lens_correctionboolean

Correct any lens distortion in the image.

contrast_boostnullable enum

The amount of contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boostnullable enum

The amount of brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

saturation_levelnullable enum

The amount of saturation to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

sharpen_levelnullable enum

The amount of sharpening to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

denoise_levelnullable enum

The amount of denoising to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

clarity_levelnullable enum

The amount of clarity to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

privacyboolean

Whether to blur any faces or license plates in the image.

window_pullboolean

Whether to pull the windows in the image (used with AI version >= 4.0).

cloud_typenullable enum

The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD

CLEARLOW_CLOUDHIGH_CLOUDnull

sky_saturation_levelnullable enum

NONELOWMEDIUMHIGHnull

contrast_boost_internalnullable enum

The amount of internal contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

contrast_boost_externalnullable enum

The amount of external contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_internalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_externalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

image_idstring (uuid)

user_idstring

The user ID of the user who uploaded (owns) the image.

order_idstring

image_namestring

image_typestring

The image type for the image.

date_addedinteger

The date the image was registered with Autoenhance.

scenestring

The detected scene of the image i.e garden, patio, kitchen, etc.

statusenum

The status of the order.

waitingprocessingprocessederror

enhancedboolean

Whether the image has been enhanced.

errorboolean

Whether the image has an error.

downloadedboolean

Whether image has been already downloaded and paid for.

ratinginteger

A rating between 0 and 5 on how good the image enhancmeent. Higher is better.

is_threesixtyany

Whether the image is a 360° image

s3PutObjectUrlany

The signed AWS S3 URL for the image to be uploaded to.

Request

JavaScriptCurl

const response = await fetch('https://api.autoenhance.ai/v3/images/', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "image_name": "text"
    }),
});
const data = await response.json();

Response

{
  "ai_version": 1.1,
  "enhance_type": "property",
  "sky_replacement": false,
  "vertical_correction": false,
  "lens_correction": false,
  "contrast_boost": "NONE",
  "brightness_boost": "NONE",
  "saturation_level": "NONE",
  "sharpen_level": "NONE",
  "denoise_level": "NONE",
  "clarity_level": "NONE",
  "privacy": false,
  "window_pull": false,
  "cloud_type": "CLEAR",
  "sky_saturation_level": "NONE",
  "contrast_boost_internal": "NONE",
  "contrast_boost_external": "NONE",
  "brightness_boost_internal": "NONE",
  "brightness_boost_external": "NONE",
  "image_id": "123e4567-e89b-12d3-a456-426614174000",
  "user_id": "text",
  "order_id": "text",
  "image_name": "text",
  "image_type": "text",
  "scene": "text",
  "status": "waiting",
  "enhanced": false,
  "error": false,
  "downloaded": false
}

Like uploading a normal image, you will receive a signed S3 endpoint for uploading your image, called "s3PutObjectURL".

To upload your bracket to our service, make a PUT request to s3PutObjectURL with the image as a buffer. You will receive a 200 success code and an empty body confirming that you’ve uploaded the image successfully.

Upload image file to pre-signed S3 URL.

PUT {{ s3PutObjectURL }

The body should contain the data for your image and the Content-Type should be equal to what. you sent when creating the image

Headers

Name	Type	Description
Content-Type*	String

200

We require you to upload all brackets of all HDRs in an order to our system before we start processing. Once that is complete, we require you to hit our HDR merge endpoint, which will start processing the orders brackets into groups to start enhancement.

Merge HDR

Trigger merging of the brackets in the order.

POSThttps://api.autoenhance.ai/v3/orders/{id}/merge

Authorization

ApiKeyAuth

Path parameters

id*string

Body

application/json

ai_versionnullable enum

1.133.13.23.34null

enhance_typenullable enum

The type of enhancement to apply to the image. PROPERTY or PROPERTY_USA is used with AI version < 4.0, for >= 4.0 use WARM, NEUTRAL, or AUTHENTIC.

propertyproperty_usawarmneutralauthenticnull

sky_replacementboolean

Enable the replacement of the original sky for a summer sky.

vertical_correctionboolean

Correct any vertical distortion in the image so that it appears straight.

lens_correctionboolean

Correct any lens distortion in the image.

contrast_boostnullable enum

The amount of contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boostnullable enum

The amount of brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

saturation_levelnullable enum

The amount of saturation to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

sharpen_levelnullable enum

The amount of sharpening to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

denoise_levelnullable enum

The amount of denoising to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

clarity_levelnullable enum

The amount of clarity to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

privacyboolean

Whether to blur any faces or license plates in the image.

window_pullboolean

Whether to pull the windows in the image (used with AI version >= 4.0).

cloud_typenullable enum

The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD

CLEARLOW_CLOUDHIGH_CLOUDnull

sky_saturation_levelnullable enum

NONELOWMEDIUMHIGHnull

contrast_boost_internalnullable enum

The amount of internal contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

contrast_boost_externalnullable enum

The amount of external contrast boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_internalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

brightness_boost_externalnullable enum

The amount of external brightness boost to apply to the image. Options include: NONE, LOW, MEDIUM, HIGH

NONELOWMEDIUMHIGHnull

Response

200401404422

Successful response

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('https://api.autoenhance.ai/v3/orders/{id}/merge', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Grouping can take between 10 seconds to 5 minutes, depending on the number of brackets that need grouping. During this time, no images will show up when you make a GET request to /order/{order_id}.

Once a grouping has been completed all groups will show up with GET /order/{order_id} and the AI will start to merge HDRs and enhance them.