Creating & Uploading

This API endpoint allows you to create an image. To create an image, you must provide a valid API key.

We've prepared quick start guides for uploading images the simplest way possible. If you're stuck, or perhaps want to see simple code examples, then start over there!

Single Image

HDR Brackets

Creating image

Create Image

post

Authorizations

Body

ai_versionstring · enumOptional

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

image_namestringRequired

lens_correctionbooleanOptional

Correct any lens distortion in the image.

Default: true

order_idstringOptional

privacyboolean | nullableOptional

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

ratinginteger · max: 5Optional

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

sky_replacementbooleanOptional

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

threesixtybooleanOptional

Whether the image is a 360 image.

upscalebooleanOptional

Whether to upscale the image.

vertical_correctionbooleanOptional

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

Default: true

window_pullboolean | nullableOptional

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

Other propertiesanyOptional

Responses

200

Successful response

application/json

401

Authentication error

application/json

422

Validation error

application/json

post

HTTPcURLJavaScriptPython

POST /v3/images/ HTTP/1.1
Host: api.autoenhance.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 382

{
  "ai_version": "text",
  "cloud_type": "CLEAR",
  "enhance": true,
  "enhance_type": "property",
  "finetune_settings": {},
  "image_name": "text",
  "lens_correction": true,
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "order_id": "text",
  "privacy": true,
  "rating": 1,
  "sky_replacement": true,
  "threesixty": true,
  "upscale": true,
  "vertical_correction": true,
  "window_pull": true,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "ai_version": "text",
  "cloud_type": "CLEAR",
  "date_added": 1,
  "downloaded": true,
  "enhance": true,
  "enhance_type": "property",
  "finetune_settings": {},
  "image_id": "123e4567-e89b-12d3-a456-426614174000",
  "image_name": "text",
  "lens_correction": true,
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "order_id": null,
  "privacy": true,
  "rating": 1,
  "scene": "text",
  "sky_replacement": true,
  "status": null,
  "status_reason": null,
  "upload_url": null,
  "upscale": true,
  "user_id": null,
  "vertical_correction": true,
  "window_pull": true,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

All of your uploaded images will contain an order_id even if you don't specify it. If you want to upload multiple images into an order, you need to specify the order_id while creating the image in our API. Learn more on the Orders page.

After successfully creating an image, the response will include an s3PutObjectUrl. To upload the physical image to our service, make a PUT request to this URL with the image in the body of the request.

Uploading image

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	Value
Content-Type	eg. image/jpeg This value has to match the used contentType in create image request!

Body

Type	Description
File or Blob	Image in a Blob or File format.

Response

200

{
  "status": "success"
}

400

{
  "error": "Invalid request"
}