Grouping Brackets and Processing Orders

This API endpoint allows you to group/merge HDR brackets in your order. To group the brackets in the order, you must provide the order_id and a valid API key.

You can group your images by specific amount of brackets when using the property number_of_brackets_per_image, we will group you brackets based on a visual analysis if you don't specify the number of brackets.

JavaScript

const apiKey = "YOUR_API_KEY";
const orderId = "ID_OF_YOUR_ORDER";
const preferences = {
  ai_version: "5.x",
  enhance: true,
  enhance_type: 'property',
  hdr: true
}
const mergeOrder = async (apiKey,orderId, preferences) => {
    return await fetch(
      `https://api.autoenhance.ai/v3/orders/${orderId}/process`,
      {
        method: "POST",
        headers: {
          "x-api-key": apiKey,
        },
        body: JSON.stringify({
          image_name: "your-image-name",
          contentType: "image/jpeg",
          ...preferences
        }),
      }
    );
}

Python

PHP

cURL

Merging 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 try to retrieve your order.

Once a grouping has been completed all groups will show up when you retrieve your order, and the AI will start to merge HDRs and enhance them.

Specification

Process Order

post

Triggers the grouping of any brackets contained in the order and process the final images in the order.

TODO: Ideally we use transactions to help deal with errors but it;s a pain with MongoEngine so need to do it as part of Django or other ORM

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

idstringRequired

Body

application/json

ai_versionstringOptional

The version of the AI model to use for enhancing the image. Versions ending in an .x will use the latest minor version as soon as it's published.

cloud_typestring · enum · nullableOptional

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

Possible values:

enhancebooleanOptional

Whether to enhance the image.

Default: true

enhance_typestring · enumOptional

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 or NEUTRAL..

Possible values:

finetune_settingsany ofOptional

object · nullableOptional

or

objectOptional

lens_correctionbooleanOptional

Correct any lens distortion in the image.

Default: true

number_of_brackets_per_imageintegerOptional

If provided then group into an image after every specified number of brackets, if not provided or set to 0 then we automatically group based on visual analysis.

preset_idstring · nullableOptional

privacyboolean · nullableOptional

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

restageany ofOptional

Restage options for in-painting or modifying scene elements. Allows correcting details like lighting a fireplace, removing fingerprints from a TV screen, or removing unwanted items like tripods.

or

object · nullableOptional

sky_replacementbooleanOptional

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

upscalebooleanOptional

Whether to upscale the image.

vertical_correctionbooleanOptional

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

Default: true

window_pull_typestring · enum · nullableOptional

What type of window pull to apply to the image (Available since AI version >= 4.0, WITH_SKIES can only be used from AI version 5.2 or higher).

Possible values:

Responses

200

Successful response

application/json

created_atstring · date-timeOptional

The creation date of the order.

default_image_sort_orderundefined · enumOptional

Default sort order for images in the order.

Possible values:

imagesanyRead-onlyOptional

The list of images for the order.

is_deletedbooleanOptional

The status of the order.

is_mergingbooleanOptional

The processing status for the order

is_processingbooleanOptional

The processing status for the order

last_updated_atstring · date-timeOptional

The last updated date of the order.

namestringOptional

The name for the order.

order_idstringOptional

The ID for the order.

statusanyRead-onlyOptional

The status of the order.

total_imagesnumberOptional

Number of images in the order.

401

Authentication error

application/json

404

Not found

application/json

422

Validation error

application/json

post

/v3/orders/{id}/process

HTTPcURLJavaScriptPython

POST /v3/orders/{id}/process HTTP/1.1
Host: api.autoenhance.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 407

{
  "ai_version": "text",
  "cloud_type": "CLEAR",
  "enhance": true,
  "enhance_type": "property",
  "finetune_settings": {},
  "images": [
    {
      "bracket_ids": [
        "text"
      ]
    }
  ],
  "lens_correction": true,
  "number_of_brackets_per_image": 1,
  "preset_id": "text",
  "privacy": true,
  "restage": {
    "fire_in_fireplaces": "AS_SHOT",
    "photographer": "AS_SHOT",
    "tvs": "AS_SHOT"
  },
  "sky_replacement": true,
  "upscale": true,
  "vertical_correction": true,
  "window_pull_type": "NONE"
}

{
  "created_at": "2026-02-24T20:30:44.502Z",
  "default_image_sort_order": "name",
  "images": null,
  "is_deleted": true,
  "is_merging": true,
  "is_processing": true,
  "last_updated_at": "2026-02-24T20:30:44.502Z",
  "name": "text",
  "order_id": "text",
  "status": null,
  "total_images": 1
}