Original

Original images are either original single-bracket or merged HDR image that you've uploaded. The only requirement for downloading original images is the image_id, you don't need an API key in order to be able to download the image.

Before you continue Original images come in various resolutions. You can add a query parameter size into the request url in order to choose between small, large or big resolution. Don't want to specify the size? Simply don't include it in the URL, and we will default the download to the biggest resolution.

JavaScript

const size = "big"

const downloadOriginalImage = async (imageId, size) => {
    const response = await fetch(
        `https://api.autoenhance.ai/v3/images/${imageId}/original${size ? size : ''}`,
        { method: "GET" }
    );
    const imageSource = await response.json()
    
    return imageSource
}

Python

import requests

size = "big"

def download_original_image(image_id,size):
    url = f'https://api.autoenhance.ai/v3/images/{image_id}/original{size if size else ""}'
    response = requests.get(url)
    image_source = response.json()
    
    return image_source

PHP

$image_id = "ID_OF_YOUR_IMAGE";
$size = "big";

function download_original_image($image_id, $size) {
    $url = "https://api.autoenhance.ai/v3/images/$image_id/original" . ($size ? $size : '');

    $options = array(
        'http' => array(
            'method' => 'GET'
        )
    );

    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);

    if ($result === FALSE) {
        return 'Error downloading image';
    }

    $image_source = json_decode($result, true);
    return $image_source;
}

cURL

curl -X GET \
  'https://api.autoenhance.ai/v3/images/YOUR_IMAGE_ID/originalbig' \
  -H 'Content-Type: application/json'

Specification

Download Original Image

get

Authorizations

x-api-keystringRequired

Path parameters

idstringRequired

Query parameters

dpiinteger · min: 72Optional

DPI of the image, must at least be 72.

qualityinteger · min: 1 · max: 90Optional

Quality of the image, must be between 1 and 90.

formatstring · enumOptional

Format of the image, must be one of 'avif', 'png', 'jpeg', 'jxl', or 'webp'.

Possible values:

previewbooleanOptional

Whether to show a lower quality preview version.

watermarkbooleanOptional

Whether to apply a watermark to the image.

visible_disclosurebooleanOptional

Whether to overlay an AI disclosure label on the image.

Default: false

finetunedboolean · nullableOptional

Whether to apply finetuning to the image.

Default: null

finetuneboolean · nullableOptional

Whether to apply finetuning to the image. Deprecated: use 'finetuned' instead.

Default: null

restagedbooleanOptional

Whether to serve the restaged version of the image. Defaults to True (serve restaged if available). Set to False to serve the original enhanced image without restaging.

Default: true

max_widthinteger · min: 1Optional

Maximum width of the image in pixels. Must be a positive integer.

scalenumber · max: 1Optional

Scale factor for the image, must be between 0.0 and 1.0.

Responses

200

Successful response

image/jpeg

string · binaryOptional

401

Authentication error

application/json

404

Not found

application/json

422

Validation error

application/json

get/v3/images/{id}/original

GET /v3/images/{id}/original HTTP/1.1
Host: api:8080
x-api-key: YOUR_API_KEY
Accept: */*

binary