API methods

The API address is https://deep-image.ai/rest_api/

There are two methods for the scheduling image processing and one for retrieving the results. With "process_result" method, image can be processed and if the result is available during 25 seconds, the url to the result will be returned. The second method - "process" - always schedules a processing job and the user has to wait for the result with "result" method.

Processing methods supports both form-data and json content types.

Apply processing to one or more images

It's convenient method that returns the url to the result immediately if the processing time is less than 25 seconds. Otherwise it will return a job hash and the result will be available via "result" method.

POST/rest_api/process_result

Authorization

Header parameters

Body

urlstring (uri)

The URL of the input image

backgroundobject

Settings for background removal

widthinteger

The desired width of the output image

heightinteger

The desired height of the output image

enhancementsarray of enum

The list of enhancements to apply to the image

light_parametersobject

Settings for the light enhancement

color_parametersobject

Settings for the color enhancement

white_balance_parametersobject

Settings for the white balance enhancement

output_formatenum

The desired output format of the image

jpegpngwebp

captionobject

Settings for adding a caption to the image

fitobject

Settings for fitting the input image into the output image

qualityinteger

The desired output image quality

max_file_sizestring

The maximum file size of the output image for JPEG or WEBP formats

Response

Job processed successfuly

Body

statusstring

jobstring

result_urlstring

Request

const response = await fetch('/rest_api/process_result', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "url": "https://deep-image.ai/api-example.png",
      "background": {
        "remove": "auto",
        "color": "#FFFFFF"
      },
      "width": 300,
      "height": 300,
      "enhancements": [
        "denoise",
        "light",
        "color"
      ],
      "light_parameters": {
        "type": "hdr_light_advanced",
        "level": 0.8
      },
      "color_parameters": {
        "type": "hdr_light_advanced",
        "level": 0.5
      },
      "output_format": "jpg",
      "caption": {
        "url": "http://ain.teonite.net/neuroapi-store/2023-02-07/d9a91e2e-9843-4d85-ae1a-e7baefc87746.png",
        "position": "RB",
        "target_width_percentage": 25,
        "padding": 20,
        "opacity": 85
      }
    }),
});
const data = await response.json();

Response

{
  "status": "complete",
  "job": "44d46e9a-c3d5-11ed-af64-0242ac1f000f",
  "result_url": "https://deep-image.ai/images/2023-03-16/2c29a22b-8ebd-461a-89b0-5feb3a33e2b1.jpg"
}

Schedules image processing job

POST/rest_api/process

Authorization

Header parameters

Body

urlstring (uri)

The URL of the input image

backgroundobject

Settings for background removal

widthinteger

The desired width of the output image

heightinteger

The desired height of the output image

enhancementsarray of enum

The list of enhancements to apply to the image

light_parametersobject

Settings for the light enhancement

color_parametersobject

Settings for the color enhancement

white_balance_parametersobject

Settings for the white balance enhancement

output_formatenum

The desired output format of the image

jpegpngwebp

captionobject

Settings for adding a caption to the image

fitobject

Settings for fitting the input image into the output image

qualityinteger

The desired output image quality

max_file_sizestring

The maximum file size of the output image for JPEG or WEBP formats

Response

Job scheduled successfuly

Body

jobstring

Request

Response

Result

GET https://deep-image.ai/rest_api/result/{hash}

Returns processing job result.

Headers

Name	Type	Description
x-api-key*	String	API Key

Name

Type

Description

x-api-key*

String

API Key

{
    "status": "in_progress",
    "job": "54e96ab8-6b3a-11ed-a4de-de00db6fc1c1"
}

{
    "status": "complete",
    "job": "54e96ab8-6b3a-11ed-a4de-de00db6fc1c1",
    "result_url": "https://deep-image.ai/images/2022-11-23/273ac2bc-fb5e-4e47-80f7-7d88a602146c.png"
}

When processing is in progress, the result endpoint should be periodically checked for the complete status.

PreviousQuick Start NextHandling Large File Sets

Last updated 5 months ago

const response = await fetch('/rest_api/process_result', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "url": "https://deep-image.ai/api-example.png", "background": { "remove": "auto", "color": "#FFFFFF" }, "width": 300, "height": 300, "enhancements": [ "denoise", "light", "color" ], "light_parameters": { "type": "hdr_light_advanced", "level": 0.8 }, "color_parameters": { "type": "hdr_light_advanced", "level": 0.5 }, "output_format": "jpg", "caption": { "url": "http://ain.teonite.net/neuroapi-store/2023-02-07/d9a91e2e-9843-4d85-ae1a-e7baefc87746.png", "position": "RB", "target_width_percentage": 25, "padding": 20, "opacity": 85 } }), }); const data = await response.json();