REST API - Send Images to PEKAT

Image processing through API works on the principle of sending the image via HTTP request and getting a response with the result (contains Context by default, but there are also other response types available). Only one image can be sent per request.

 

Enable Process

User must enable ‘Process’ on the left of the panel in Camera tab to be able to process the image sent through API.

 

 

Request

The sending address consists of IP address, port, type and optionally further query parameters. The request method must be of ‘POST’ type, and the content type of ‘application/octet-stream’ type.

Find a practical API demonstration in Python at GitHub Image Analyze API.

IP Address

If the project runs on a local computer, the address is 127.0.0.1. If a remote computer is accessed, then you need to use the IP address of the remote computer.

Port

This is selected when starting the project.

API Key

If the project is running with “Secure image analyze” option enabled, each request in the parameter query must contain the API key that is generated after you enable this option.

 

'http://127.0.0.1:8000/analyze_image?api_key=553d7790-827c-11ec-978b-6da1176c0b00'

Data

You can add extra information to the request. This string will be added to the context (key is data). It is available only in the Code module (context variable).

'http://127.0.0.1:8000/analyze_image?data=SomeInfo'

In Code module you can access this string using:

context['data']

Types

analyze_raw_image

Used for sending the image as raw data. For example, the numpy array in Python is converted to binary format.

 

You need to send the image dimensions in query parameters width and height.

Example of a 1920x1024 image:

 

If you are sending Bayer RG 8 data, it is necessary to add an argument bayer.

 

Example of a Python code sending requests with raw images from camera:

analyze_image

Is used for sending an image in ‘jpg’ or ‘png’ formats.

 

Basic example

 

Example with API key

 

Example Python code which sends images from a folder to Pekat project with API key:

last_image

Gets the last image/context that was analyzed in the given project before.

Basic example (gets just the context)

Python code which gets the last processed image with heatmap and shows it, then prints out the context.

Response type

Query parameter ‘response_type’ determines what content will be sent in the response that is returned from PEKAT VISION after processing the request. The request url changes in the following way (example for annotated_image response type):

If there are multiple query parameters, connect with '&', e.g. with API key:

Context

context – a serialized context in JSON format. The contents are explained on the Context page. You can access the context json from response using:

Images

Further options return a PNG image in binary form in the response. It needs to be decoded afterwards to further work with it as an image.

Example of decoding and showing the image with PIL library:

Example of decoding and showing the image with OpenCV library:

 

image – processed image - output image that passed through the flow, but without any heatmaps or rectangles (e.g. if the image is scaled during the flow, it returns scaled image).

annotated_image – processed image with annotations - heatmaps over the image

heatmap - response contains only the heatmaps over the image (without the image)

 

For all those image response types, the serialized context is by default added to the headers with the header title 'ContextBase64utf'. To get it to json form, you can use this code:

Context in body

When gettting an image in the response, by default the context is sent in headers. However, with a very large number of defects, the maximum header length limit can be reached. To solve this, you can use the option to send context in the body of the response together with the image and get the image length in a header 'ImageLen' to be able to divide the two parts after. To activate this mode, add the following to the request:

Example Python code of the usage when getting last image:

Testing the API functionality

If you have a running project on a port e.g. 8000, you can test the API by accessing this address in your browser (if PEKAT is running on the local computer, otherwise replace localhost with IP address of the remote PC):

This displays the testing app, where you can choose to display the last processed image or send a new image to analyze. You can choose the Response type - Context, Image, Annotated image (image with a heatmap) or Heatmap. If the project has Secure image analyze enabled, you also need to enter the API key.

If Analyze image is chosen, you can also select the image that will be sent through the API. If response type is different than Context, the default behavior is that the image is sent in the body of the response and the context is sent in the headers - to change this and send both in the body, check the box with Context in body. The detail of the request structure will be displayed.

After you click Send, you will also see the structure of the response in the blue info box, context (as you would see it in Inspection) and optionally an image based on the response type.