Anonymize a file

post

http://localhost:8787/{service}/v4/{out_type}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

service

string

enum

required

Selection of the service to be performed on the data. Current services are a traditional blur anonymization (blur), mask anonymization (experimental - replace PIIs with zeros), a natural anonymization (dnat) based on Brighter AI's Deep Natural Anonymization™ technology, and a labeling service of the original personal identifiable information (PIIs) locations (redact_area).

Allowed:

out_type

string

enum

required

Output resource type of the service. Supports videos, images, archives and overlays. Overlays only contain the targeted PIIs without the original background.

Allowed:

Query Params

region

string

enum

Defaults to germany

Geographic region of the data, for performing region-specific replacement of PIIs.

Allowed:

face

boolean

Defaults to true

Whether to target faces on the selected service.

license_plate

boolean

Defaults to true

Whether to target license plates on the selected service.

full_body

boolean

Defaults to false

Whether to target full bodies on the selected service.

vehicle_recorded_data

boolean

Defaults to false

Deprecated, option to optimize for vehicle recorded data.

speed_optimized

boolean

Defaults to false

Option to increase processing speed.

single_frame_optimized

boolean

Defaults to false

Option to make every frame of a multi frame source be run independently.

lp_determination_threshold

number

Defaults to 0.5

Experimental Option to adjust the determination threshold for license plate detections, in the range of [0, 1]. Advanced users can change this value to override the default internal threshold for better accuracy on their data domain. The threshold value corresponds to the preference for reduction of false positives (anonymized identities that are not there) vs false negatives (missed identities). A threshold of 1.0 minimizes false positives as much as possible, a threshold of 0.0 minimizes false negatives as much as possible, and a threshold of 0.5 gives them both equal weighting. Note that there is no guarantee that this threshold will work on other data and after algorithm updates.

face_determination_threshold

number

Defaults to 0.364

Experimental Option to adjust the determination threshold for faces, in the range of [0, 1]. Advanced users can change this value to override the default internal threshold for better accuracy on their data domain. Note that there is no guarantee that this threshold will work on other data and after algorithm updates.

full_body_segmentation_threshold

number

Defaults to 0.3

Option to adjust the determination threshold for full bodies, in the range of [0, 1]. Advanced users can change this value to override the default internal threshold for better accuracy on their data domain. Note that there is no guarantee that this threshold will work on other data and after algorithm updates.

status_webhook_url

string

A URL to call when the status of the Job changes

areas_of_interest

array

Experimental Only fully supported and tested for output type of videos and service type blur! Areas of interest's top left corner coordinates x and y, their height and width. Each area must be provided as a string in the following format [x,y,width,height]. Multiple areas can be defined but are not allowed to overlap. For example, one area "...&areas_of_interest=[0,0,960,540]", two areas "...&areas_of_interest=[[0,0,960,540],[0,540,960,540]]", two areas "...&areas_of_interest=[0,0,960,540]&areas_of_interest=[0,540,960,540]". The parameter might not yet fully work with all parameters and output types.

Areas Of Interest

Body Params

file

required

Input file for the service. For a list of all supported codecs and containers please follow the link on top of the page 'Service Support'.

licence_plate_custom_stamp

file

Option to replace original license plates with a specific image instead of generated realistic license plates.

Responses

422

You get this response when invalid parameters were provided. Please also see 'Service Support' above to see the main available processing options and formats.

200You get this response when your file was successfully submitted to the selected service. The service generates an ID in UUID format of the output resource that is beeing processed. You can use this resource ID to get, control and delete the resulting resource.

403You get this response when your submission is not allowed by your current license.

415You get this response when the input file has an unsupported format.