LUNA PLATFORM 5 API (v.6.23.0)

Download OpenAPI specification:Download

VisionLabs Luna Platform 5 API. The API version is 6.

OpenAPI specification is the only valid document providing up-to-date information about the service API.

The specification can be used:

By documentation generation tools to visualize the API.
By code generation tools.

All the documents and code generated using this specification can include inaccuracies and should be carefully checked.

OpenAPI specification can be received using the /docs/spec resource. The "Accept" header should be set to "application/x-yaml".

version

get version

Get versions of services.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

200
408
500
503
504

Content type

application/json

{"LUNA PLATFORM": {"major": 0,
"minor": 0,
"patch": 0
},
"luna-api": {"api": 5,
"major": 3,
"minor": 1,
"patch": 2
},
"luna-events": {"api": 1,
"major": 1,
"minor": 0,
"patch": 5
},
"luna-faces": {"api": 2,
"major": 2,
"minor": 3,
"patch": 9
},
"luna-image-store-bodies-samples": {"api": 1,
"major": 2,
"minor": 1,
"patch": 11
},
"luna-image-store-faces-samples": {"api": 1,
"major": 2,
"minor": 1,
"patch": 10
},
"luna-image-store-images": {"api": 1,
"major": 2,
"minor": 1,
"patch": 13
},
"luna-handlers": {"api": 1,
"major": 1,
"minor": 0,
"patch": 0
},
"luna-tasks": {"api": 1,
"major": 1,
"minor": 0,
"patch": 13
},
"luna-matcher-proxy": {"api": 1,
"major": 1,
"minor": 0,
"patch": 0
},
"luna-remote-sdk": {"api": 1,
"major": 1,
"minor": 0,
"patch": 0
},
"luna-lambda": {"api": 1,
"major": 1,
"minor": 0,
"patch": 0
}
}

version options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

accounts

get accounts

query Parameters

page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.
login	string (login) [ 3 .. 128 ] characters ^[a-z0-9_\-\.]+@[a-z]+\.[a-z]{2,}$ Example: login=user@visionlabs.ru account login
account_type	string (account_type) Enum: "advanced_user" "user" "admin" Example: account_type=user account type
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for object create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for object create_time.
targets	string Default: ["account_id","login","account_type","description","create_time","last_update_time"] Enum: "account_id" "login" "account_type" "description" "create_time" "last_update_time" Example: targets=login Comma-separated list of account target fields. Available targets: account_id, login, account_type, description, create_time, last_update_time

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

url = f"{baseUri}/accounts"
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"accounts": [{"account_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"login": "mylogin@gmail.com",
"account_type": "advanced_user",
"description": "main admin account",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}
],
"total_count": 50
}

create account

Create an account.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID for new account creation.

Request Body schema: application/json

login required	string (login) [ 3 .. 128 ] characters ^[a-z0-9_\-\.]+@[a-z]+\.[a-z]{2,}$ Account email.
password required	string (password) [ 3 .. 128 ] characters ^.{3,128}$ Account password.
account_type required	string (account_type_for_creation) Enum: "advanced_user" "user" Specified user account type: `user` - allows to interact with its own data `advanced_user` - allows to interact with its own data and view other accounts data
description	string (account_description) <= 128 characters Default: "" Account description.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"login": "mylogin@gmail.com",
"password": "string",
"account_type": "advanced_user",
"description": "main admin account"
}

Response samples

Content type

application/json

{"account_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"url": "/6/account",
"external_url": "http://127.0.0.1:5000/6/account"
}

accounts options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

account

get account

Get account.

Authorizations:

BasicAuthLunaAccountIdAuth

query Parameters

targets

string

Default: ["account_id","login","account_type","description","create_time","last_update_time"]

Enum: "account_id" "login" "account_type" "description" "create_time" "last_update_time"

Example: targets=login

Comma-separated list of account target fields. Available targets: account_id, login, account_type, description, create_time, last_update_time

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

url = f"{baseUri}/account"
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"account_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"login": "mylogin@gmail.com",
"account_type": "advanced_user",
"description": "main admin account",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}

patch account

Patch account. At least one field must be specified.

Authorizations:

BasicAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

non-empty

login	string (login) [ 3 .. 128 ] characters ^[a-z0-9_\-\.]+@[a-z]+\.[a-z]{2,}$ Account email.
password	string (password) [ 3 .. 128 ] characters ^.{3,128}$ Account password.
account_type	string (account_type_for_creation) Enum: "advanced_user" "user" Specified user account type: `user` - allows to interact with its own data `advanced_user` - allows to interact with its own data and view other accounts data
description	string (account_description) <= 128 characters Default: "" Account description.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"login": "mylogin@gmail.com",
"password": "string",
"account_type": "advanced_user",
"description": "main admin account"
}

Response samples

Content type

application/json

Example

extra_fields

{"error_code": 12022,
"desc": "Bad/incomplete input data",
"detail": "Failed to validate input json. Path: 'extra_field',  message: 'extra fields not permitted'"
}

accounts options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

tokens

create token

Create a token.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

grant_all_permissions

integer

Default: 0

Enum: 0 1

Grant all permissions to token. 1 - give, 0 - do not give. If value is 1 then permissions field is not required.

Grant only standart permissions.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

Any of

required	object token permissions * it is possible to use custom fields for permissions besides those given here custom fields must have 3-16 characters (lowercase letters, _) with possible permissions: `"creation"`, `"view"`, `"modification"`, `"deletion"` `"creation"` — allows POST requests `"view"` — allows GET requests `"modification"` — allows PUT and PATCH requests `"deletion"` — allows DELETE requests
description	string (token_description) <= 128 characters Default: "" Token description.
expiration_time required	string or null <date-time> Token expiration time in RFC 3339 format. `null` means token will never expired.
visibility_area	string (visibility_area) Default: "all" Enum: "account" "all" Specifies data visible for the token. `account` - only data related to this account can be received using GET requests. `all` - data of all existing accounts can be received using GET requests. This value can be set for `advanced_user` account. This option does not work for user account.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "main account token",
"expiration_time": "2050-11-11T11:11:11.111+03:00",
"permissions": {"face": ["creation",
"view",
"modification",
"deletion",
"matching"
],
"list": ["creation",
"view",
"modification",
"deletion"
],
"event": ["creation",
"view",
"matching"
],
"attribute": ["creation",
"view",
"modification",
"deletion",
"matching"
],
"handler": ["creation",
"view",
"modification",
"deletion"
],
"verifier": ["creation",
"view",
"modification",
"deletion"
],
"task": ["creation",
"view",
"modification",
"deletion"
],
"face_sample": ["creation",
"view",
"deletion"
],
"body_sample": ["creation",
"view",
"deletion"
],
"image": ["creation",
"view",
"deletion"
],
"object": ["creation",
"view",
"deletion"
],
"token": ["creation",
"view",
"modification",
"deletion"
],
"resources": ["iso",
"sdk",
"liveness"
],
"emit_events": {"allowed": 1,
"white_list": null,
"black_list": null
},
"lambdas": ["creation",
"view",
"modification",
"deletion"
]
},
"visibility_area": "all"
}

Response samples

Content type

application/json

{"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbklkIjoiN2Q0MjYwNmEtZmM3NS00NDU4LWE3OGUtOWYzNGM2MjIyZWQyIiwiZXhwaXJhdGlvblRpbWUiOm51bGwsImFjY291bnRJZCI6IjdkYjUzNThiLWZjMzMtNDIwZC1hYTgzLTk5YTRkOWY0MGM0MSJ9.kDL5oLTJaxKyYbwmKV1lejxrzsFoFzx5VOzvTR-i90k",
"token_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"url": "/6/tokens/557d54ec-29ad-4f3c-93b4-c9092ef12515",
"external_url": "http://127.0.0.1:5000/6/tokens/557d54ec-29ad-4f3c-93b4-c9092ef12515"
}

get tokens

Get tokens.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.
account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for object create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for object create_time.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create token
url = f"{baseUri}/tokens"
headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}
payload = {"permissions": {"face": ["view"]}, "description": "description"}
requests.post(url, json=payload, headers=headers)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}
url = f"{baseUri}/tokens"
response = requests.get(url, headers=headers, params={"page": 1, "page_size": 10})

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"tokens": [{"permissions": {"face": [ ],
"list": [ ],
"event": [ ],
"attribute": [ ],
"handler": [ ],
"verifier": [ ],
"task": [ ],
"face_sample": [ ],
"body_sample": [ ],
"image": [ ],
"object": [ ],
"token": ["view"
],
"resources": [ ],
"emit_events": {"allowed": 1,
"white_list": null,
"black_list": null
},
"lambdas": [ ]
},
"description": "main account token",
"expiration_time": "2050-11-11T11:11:11.111+03:00",
"visibility_area": "account",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbklkIjoiN2Q0MjYwNmEtZmM3NS00NDU4LWE3OGUtOWYzNGM2MjIyZWQyIiwiZXhwaXJhdGlvblRpbWUiOm51bGwsImFjY291bnRJZCI6IjdkYjUzNThiLWZjMzMtNDIwZC1hYTgzLTk5YTRkOWY0MGM0MSJ9.kDL5oLTJaxKyYbwmKV1lejxrzsFoFzx5VOzvTR-i90k",
"token_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"account_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}
]
}

tokens options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

replace token

Update token. You cannot update a part of the token, so you should specify all the fields for your token.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

token_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 8950722f-3fd4-4223-b48f-03f95f0e8dfb

Token ID.

query Parameters

grant_all_permissions

integer

Default: 0

Enum: 0 1

Grant all permissions to token. 1 - give, 0 - do not give. If value is 1 then permissions field is not required.

Grant only standart permissions.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

Any of

required	object token permissions * it is possible to use custom fields for permissions besides those given here custom fields must have 3-16 characters (lowercase letters, _) with possible permissions: `"creation"`, `"view"`, `"modification"`, `"deletion"` `"creation"` — allows POST requests `"view"` — allows GET requests `"modification"` — allows PUT and PATCH requests `"deletion"` — allows DELETE requests
description	string (token_description) <= 128 characters Default: "" Token description.
expiration_time required	string or null <date-time> Token expiration time in RFC 3339 format. `null` means token will never expired.
visibility_area	string (visibility_area) Default: "all" Enum: "account" "all" Specifies data visible for the token. `account` - only data related to this account can be received using GET requests. `all` - data of all existing accounts can be received using GET requests. This value can be set for `advanced_user` account. This option does not work for user account.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

token_to_create

{"permissions": {"face": [ ],
"list": [ ],
"event": [ ],
"attribute": [ ],
"handler": [ ],
"verifier": [ ],
"task": [ ],
"face_sample": [ ],
"body_sample": [ ],
"image": [ ],
"object": [ ],
"token": ["view"
],
"resources": [ ],
"emit_events": {"allowed": 1,
"white_list": null,
"black_list": null
},
"lambdas": [ ]
},
"description": "main account token",
"expiration_time": "2050-11-11T11:11:11.111+03:00",
"visibility_area": "account"
}

Response samples

Content type

application/json

{"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbklkIjoiN2Q0MjYwNmEtZmM3NS00NDU4LWE3OGUtOWYzNGM2MjIyZWQyIiwiZXhwaXJhdGlvblRpbWUiOm51bGwsImFjY291bnRJZCI6IjdkYjUzNThiLWZjMzMtNDIwZC1hYTgzLTk5YTRkOWY0MGM0MSJ9.kDL5oLTJaxKyYbwmKV1lejxrzsFoFzx5VOzvTR-i90k",
"token_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"url": "/6/tokens/557d54ec-29ad-4f3c-93b4-c9092ef12515",
"external_url": "http://127.0.0.1:5000/6/tokens/557d54ec-29ad-4f3c-93b4-c9092ef12515"
}

get token

Get token by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

token_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 8950722f-3fd4-4223-b48f-03f95f0e8dfb

Token ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library
import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}
url = f"{baseUri}/tokens"
payload = {"permissions": {"face": ["view"]}, "description": "description", "expiration_time": None}
tokenId = requests.post(url, json=payload, headers=headers).json()["token_id"]

url = f"{baseUri}/tokens/{tokenId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"permissions": {"face": [ ],
"list": [ ],
"event": [ ],
"attribute": [ ],
"handler": [ ],
"verifier": [ ],
"task": [ ],
"face_sample": [ ],
"body_sample": [ ],
"image": [ ],
"object": [ ],
"token": ["view"
],
"resources": [ ],
"emit_events": {"allowed": 1,
"white_list": null,
"black_list": null
},
"lambdas": [ ]
},
"description": "main account token",
"expiration_time": "2050-11-11T11:11:11.111+03:00",
"visibility_area": "account",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbklkIjoiN2Q0MjYwNmEtZmM3NS00NDU4LWE3OGUtOWYzNGM2MjIyZWQyIiwiZXhwaXJhdGlvblRpbWUiOm51bGwsImFjY291bnRJZCI6IjdkYjUzNThiLWZjMzMtNDIwZC1hYTgzLTk5YTRkOWY0MGM0MSJ9.kDL5oLTJaxKyYbwmKV1lejxrzsFoFzx5VOzvTR-i90k",
"token_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"account_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}

delete token

Delete token by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

token_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 8950722f-3fd4-4223-b48f-03f95f0e8dfb

Token ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library
import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}
url = f"{baseUri}/tokens"
payload = {"permissions": {"face": ["view"]}, "description": "description", "expiration_time": None}
tokenId = requests.post(url, json=payload, headers=headers).json()["token_id"]

url = f"{baseUri}/tokens/{tokenId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

token options

Get options for the resource.

path Parameters

token_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 8950722f-3fd4-4223-b48f-03f95f0e8dfb

Token ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

credentials verifier

verify credentials

Verify account or login with password or token.

In the case of success account id verification, account_type will be returned
In the case of success login/password verification, account_id and account_type will be returned
In the case of success token verification, account_type and token permissions will be returned
In the case of failure verification, error will be returned

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

One of

login required	string (login) [ 3 .. 128 ] characters ^[a-z0-9_\-\.]+@[a-z]+\.[a-z]{2,}$ Account email.
password required	string (password) [ 3 .. 128 ] characters ^.{3,128}$ Account password.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

verifier_login_password

{"login": "mylogin@gmail.com",
"password": "string"
}

Response samples

Content type

application/json

{"account_type": "advanced_user",
"permissions": {"face": [ ],
"list": [ ],
"event": [ ],
"attribute": [ ],
"handler": [ ],
"verifier": [ ],
"task": [ ],
"face_sample": [ ],
"body_sample": [ ],
"image": [ ],
"object": [ ],
"token": ["view"
],
"resources": [ ],
"emit_events": {"allowed": 1,
"white_list": null,
"black_list": null
},
"lambdas": [ ]
},
"account_id": "string"
}

credentials verifier options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

sdk

sdk resource

Detect faces and/or human bodies and estimate attributes on the input images. After the request is performed, the received data is not saved to the database or Image Store, it is only returned in the response.

The order of input images corresponds to the order of the elements in the output JSON.

If an input image is corrupted, an error is returned for the image. The processing of the other images continues in normal mode.

Notes for incoming data:

face or body bounding boxes passed with face or body warped image will be ignored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

image_type

integer

Default: 0

Enum: 0 1 2

Type of input image. 0 - raw image, 1 - face warped image, 2 - body warped image.

estimate_people_count

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate people count on the image.

⚠ People counter licensing feature is required to be enabled to perform estimation.

multiface_policy

integer (multiface_policy)

Default: 1

Enum: 0 1 2

Multiple face detection policy:

0 - do not process images with several detected faces.

If detect_body is enabled, the system will attempt to detect a human body related to the detected face. If a human body is detected, its detection will be associated with the same event as the face.

If there is no face detected in the image, no human body detections will be returned. Thus there will be no human body detection returned if detect_face is disabled.
1 - process images with several detected faces and/or human bodies.

If detect_body is enabled, all the detections of human bodies will be returned. Face detection and human body detection of the same person will be associated with the same event.

The detections of human bodies are returned even if there were no faces found.
2 - get the best face detection from the image. A single face of the best quality is detected in the image.

If detect_body is enabled, the system will attempt to detect a human body related to the detected face. If a human body is detected, its detection will be associated with the same event as the face.

If there is no face detected in the image, no human body detections will be returned. Thus there will be no human body detection returned if detect_face is disabled.

detect_face

integer (detect_face)

Default: 0

Enum: 0 1

Whether to detect faces on the image.

detect_body

integer (detect_body)

Default: 0

Enum: 0 1

Whether to detect human bodies on the image.

estimate_head_pose

integer (estimate_head_pose)

Default: 0

Enum: 0 1

Whether to estimate head pose in the image. The head pose is represented by pitch, yaw and roll angles.

Not supported with warped images (see warped_image or image_type parameter).

estimate_emotions

integer (estimate_emotions)

Default: 0

Enum: 0 1

Whether to estimate emotions in the image. The probability of the following emotions is estimated: "anger", "disgust", "fear", "happiness", "sadness", "surprise", "neutral".

estimate_mask

integer (estimate_mask)

Default: 0

Enum: 0 1

Whether to estimate mask in the image. The probability of the following masks states is estimated: "medical_mask", "missing", "occluded".

The estimated probability with the highest score is returned in the "predominant mask" parameter.

estimate_glasses

integer (estimate_glasses)

Default: 0

Enum: 0 1

Whether to estimate glasses in the image. One of the following parameters is returned: "eyeglasses", "sunglasses", "no_glasses".

estimate_liveness

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate liveness in the image. The "quality" and "score" probabilities are estimated. Based on these probabilities, the following result is returned: "real", "spoof", "unknown".

Liveness is utilized for this estimation. See "Administrator’s manual" for details about Liveness requirements.

⚠ Webcam or selfie photos are required. Otherwise the result may be incorrect.

⚠ Liveness licensing feature is required to be enabled to perform liveness estimation.

Liveness estimation is not supported for samples (warped images). The image_type parameter should be set to "0".

estimate_deepfake

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate deepfake feature on the image.

⚠ Deepfake licensing feature is required to be enabled to perform deepfake estimation.

Not supported with warped images (see warped_image parameter).

estimate_landmarks68

integer (detect_landmarks68)

Default: 0

Enum: 0 1

Whether to detect basic 68-point facial landmarks in the image.

Not supported with warped images (see warped_image or image_type parameter).

estimate_landmarks5

integer (detect_landmarks5)

Default: 0

Enum: 0 1

Whether to detect basic 5-point facial landmarks in the image.

Not supported with warped images (see warped_image or image_type parameter).

estimate_quality

integer (estimate_quality)

Default: 0

Enum: 0 1

Whether to estimate input face image quality. Each of the following probabilities is estimated: "darkness", "light", "blurriness", "illumination", "specularity".

The quality factor is estimated for each probability. It's value is in the range [0..1] where 0 corresponds to low quality and 1 to high quality.

Note. Face recognition is not greatly affected by uneven illumination or high specularity.

estimate_gaze

integer (estimate_gaze)

Default: 0

Enum: 0 1

Whether to estimate gaze in the image. The gaze is represented by yaw angle and pitch angle for both eyes at once.

Not supported with warped images (see warped_image or image_type parameter).

estimate_eyes_attributes

integer (estimate_eyes_attributes)

Default: 0

Enum: 0 1

Whether to estimate eye attributes in the image. The "right_eye" and "left_eye" parameters are estimated, which contain the "state" (opened, closed or occluded) and "iris_landmarks" parameters.

estimate_mouth_attributes

integer (estimate_mouth_attributes)

Default: 0

Enum: 0 1

Whether to estimate mouth attributes in the image. Each of the following probabilities is estimated: "opened", "occluded", "smile", "score".

estimate_face_descriptor

integer (extract_descriptor)

Default: 1

Enum: 0 1

Example: estimate_face_descriptor=1

Whether to estimate face descriptor(s).

estimate_basic_attributes

integer (extract_basic_attributes)

Default: 0

Enum: 0 1

Whether to estimate face basic attributes (gender, age, ethnicity).

estimate_body_descriptor

integer (extract_descriptor)

Default: 1

Enum: 0 1

Example: estimate_body_descriptor=1

Whether to create human body descriptor(s).

estimate_upper_body

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate human upper body on the image (headwear, clothing color, sleeve length).

estimate_lower_body

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate human lower body on the image (lower garment, shoes).

estimate_accessories

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate human body accessories on the image (backpack presence).

estimate_body_basic_attributes

integer (int01)

Default: 0

Enum: 0 1

Whether to estimate human body basic attributes on the image (age, gender).

estimate_body_warp

integer (estimate_body_warp)

Default: 0

Enum: 0 1

Whether to create a human body warped image in the Base64 format.

estimate_face_warp

integer (estimate_face_warp)

Default: 0

Enum: 0 1

Whether to create the face warped image in the Base64 format.

aggregate_attributes

integer (aggregate_attributes)

Whether to aggregate the following parameters:

face descriptor
body descriptor
face basic attributes (age, gender)
body basic attributes (apparent age, apparent gender)
mask states
emotions
liveness
deepfake
upper body attributes
lower body attributes
accessories

Aggregation will be performed only if the appropriate parameters for estimating the listed above parameters are enabled.

If set, all estimated parameters from each image will be aggregated and displayed in the aggregate_estimations field of the response body as single objects for all images.

Otherwise, all estimated parameters from each image will be displayed in the estimations field of the response body as separate objects for corresponding images.

pitch_threshold

integer (pitch_threshold) [ 0 .. 180 ]

Example: pitch_threshold=180

Maximum deviation pitch angle from 0. If the estimated value is equal or less than the threshold, the image is filtered.

Remove this parameter from the query, or set the parameter value to 180 if pitch angle filtration is not required.

When the value is set to "0", all the images are filtered.

roll_threshold

integer (roll_threshold) [ 0 .. 180 ]

Example: roll_threshold=180

Maximum deviation roll angle from 0. If the estimated value is equal or less than the threshold, the image is filtered.

Remove this parameter from the query, or set the parameter value to 180 if roll angle filtration is not required.

When the value is set to "0", all the images are filtered.

yaw_threshold

integer (yaw_threshold) [ 0 .. 180 ]

Example: yaw_threshold=180

Maximum deviation yaw angle from 0. If the estimated value is equal or less than the threshold, the image is filtered.

Remove this parameter from the query, or set the parameter value to 180 if yaw angle filtration is not required.

When the value is set to "0", all the images are filtered.

score_threshold

number (score_threshold) [ 0 .. 1 ]

Default: 0

Example: score_threshold=0.7

Descriptor quality score threshold. The higher the quality score for the image, the better the extraction results.

All the attributes with a quality score below the threshold will be ignored (and not stored in the DB). The function will proceed as usual with all the remaining descriptors (if left).

Consult VisionLabs about the recommended value of this parameter.

Note! This parameter is not related to the image quality estimated in the detect request (estimate_quality request parameter).

mask_states

Array of integers (mask_states) non-empty

Items Enum: 1 2 3

Example: mask_states=2&mask_states=3

Filter by mask states.

mask state	value
missing	1
medical_mask	2
occluded	3

liveness_states

Array of integers (liveness_states) non-empty

Items Enum: 0 1 2

Example: liveness_states=1

Filter by liveness states.

liveness state	value
spoof	0
real	1
unknown	2

deepfake_states

Array of integers (deepfake_states) non-empty

Items Enum: 0 1

Example: deepfake_states=1

Filter by deepfake states.

deepfake state	value
fake	0
real	1

use_exif_info

integer

Default: 1

Enum: 0 1

Example: use_exif_info=1

Whether to try to auto orient image based on EXIF data.

The processed image should have EXIF data, otherwise auto orientation will not be performed.

Has no effect with tiff images (they're always auto oriented).

Ignored with warped images (see warped_image or image_type parameter).

extract_exif

integer (extract_exif)

Default: 0

Enum: 0 1

Whether to extract EXIF meta information from input JPEG images.

Exact output will vary since there are no mandatory requirements for both authoring software and digital cameras how to write the data.

This function will only parse the tags and output their names and values as they are. Please refer to JEITA CP-3451 EXIF specification for details.

header Parameters

Accept	string Enum: "application/json" "application/msgpack" Accept request header.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Enum: "application/json" "multipart/form-data" "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64"
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema:
image/jpeg

string <binary>

Responses

Request samples

Payload
python
python
bash

Content type

image/jpeg

No sample

Response samples

Content type

application/json

Example

face_and_body_example

{"images_estimations": [{"filename": "raw image",
"exif": {"make": "Apple",
"model": "iPhone 11",
"gps": {"latitude": "55.0, 45.0, 18.29",
"longitude": "37.0, 39.0, 16.32"
},
"software": "13.6.1",
"orientation": 6
},
"estimations": [{"face": {"detection": {"rect": {"x": 71,
"y": 45,
"width": 134,
"height": 178
},
"landmarks5": [[25,
25
],
[83,
83
],
[47,
47
],
[33,
33
],
[82,
82
]
],
"landmarks68": [[1,
1
],
[1,
1
],
[4,
4
],
[8,
8
],
[14,
14
],
[23,
23
],
[33,
33
],
[43,
43
],
[60,
60
],
[78,
78
],
[96,
96
],
[112,
112
],
[124,
124
],
[132,
132
],
[135,
135
],
[137,
137
],
[138,
138
],
[1,
1
],
[8,
8
],
[17,
17
],
[26,
26
],
[35,
35
],
[59,
59
],
[73,
73
],
[86,
86
],
[100,
100
],
[113,
113
],
[47,
47
],
[45,
45
],
[44,
44
],
[43,
43
],
[37,
37
],
[42,
42
],
[47,
47
],
[54,
54
],
[61,
61
],
[14,
14
],
[20,
20
],
[29,
29
],
[36,
36
],
[28,
28
],
[19,
19
],
[69,
69
],
[77,
77
],
[86,
86
],
[95,
95
],
[88,
88
],
[78,
78
],
[33,
33
],
[38,
38
],
[45,
45
],
[50,
50
],
[57,
57
],
[69,
69
],
[82,
82
],
[72,
72
],
[60,
60
],
[52,
52
],
[45,
45
],
[38,
38
],
[36,
36
],
[46,
46
],
[51,
51
],
[58,
58
],
[77,
77
],
[58,
58
],
[51,
51
],
[45,
45
]
],
"attributes": {"eyes_attributes": {"left_eye": {"iris_landmarks": [[92,
92
],
[92,
92
],
[93,
93
],
[93,
93
],
[94,
94
],
[95,
95
],
[96,
96
],
[98,
98
],
[99,
99
],
[100,
100
],
[101,
101
],
[102,
102
],
[103,
103
],
[104,
104
],
[105,
105
],
[105,
105
],
[105,
105
],
[105,
105
],
[105,
105
],
[104,
104
],
[103,
103
],
[102,
102
],
[101,
101
],
[100,
100
],
[99,
99
],
[98,
98
],
[97,
97
],
[96,
96
],
[95,
95
],
[94,
94
],
[93,
93
],
[93,
93
]
],
"state": "open"
},
"right_eye": {"iris_landmarks": [[152,
152
],
[153,
153
],
[153,
153
],
[154,
154
],
[154,
154
],
[155,
155
],
[157,
157
],
[158,
158
],
[159,
159
],
[161,
161
],
[162,
162
],
[163,
163
],
[164,
164
],
[165,
165
],
[166,
166
],
[166,
166
],
[166,
166
],
[166,
166
],
[166,
166
],
[165,
165
],
[164,
164
],
[163,
163
],
[162,
162
],
[161,
161
],
[159,
159
],
[158,
158
],
[158,
158
],
[157,
157
],
[156,
156
],
[154,
154
],
[154,
154
],
[153,
153
]
],
"state": "open"
}
},
"head_pose": {"pitch": 12.7464532852,
"roll": -2.9892115593,
"yaw": 17.7173442841
},
"gaze": {"yaw": -5.9912848473,
"pitch": -10.2646684647
},
"emotions": {"predominant_emotion": "neutral",
"estimations": {"anger": 8.682e-7,
"disgust": 1.0670000000000001e-7,
"fear": 4.386e-7,
"happiness": 0.45658952,
"sadness": 4.951e-7,
"surprise": 0.0000029291,
"neutral": 0.543405652
}
},
"mask": {"predominant_mask": "occluded",
"estimations": {"medical_mask": 0.020060448,
"missing": 0.3235525191,
"occluded": 0.6563870311
},
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"glasses": {"glasses": "no_glasses"
},
"mouth_attributes": {"score": 0.3884400725,
"occluded": 1.4000000000000001e-9,
"smile": 0.6115599275,
"opened": 0.121500025
},
"basic_attributes": {"ethnicities": {"predominant_ethnicity": "caucasian",
"estimations": {"asian": 0.0000025556,
"indian": 6.417e-7,
"caucasian": 0.9999949932000001,
"african_american": 0.0000017718000000000001
}
},
"age": 24,
"gender": 0
},
"descriptor": {"sdk_descriptor": "ZHAAADgAAAB0k4SAf...IB6gHyAgH19fQ==",
"score": 0.7854047418000001
},
"liveness": {"prediction": "spoof",
"estimations": {"quality": 0.7361597418785095,
"score": 0.600364089012146
}
},
"deepfake": {"prediction": "fake",
"score": 0.600364089012146
}
},
"quality": {"blurriness": 0.9769582748000001,
"dark": 0.9542820454000001,
"illumination": 0.8248310089,
"specularity": 0.8472354412,
"light": 0.8179533482
},
"warp": "/9j/4AAQSkZJRgABAQAAAQABA..C4gb+KneZD/erEHWn0/asOTzP/9k="
}
},
"body": {"detection": {"rect": {"x": 32,
"y": 4,
"width": 224,
"height": 255
},
"warp": "/9j/4AAQSkZJRgABAQAAAQABAA...CX6kdapTi1qS00f/Z",
"attributes": {"descriptor": {"sdk_descriptor": "ZHAAAGUAAAC....AfX9",
"score": 1
},
"basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
}
}
}
],
"image_estimations": {"people": {"count": 1
}
}
}
]
}

sdk options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

videosdk

video analytics (beta)

Request for video analysis based on the specified analytics parameters eg facial estimations.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json"

Request Body schema: application/json

required	object Video URL.
required	Array of objects (people_count_analytics) A list of parameters for comprehensive video analytics.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"video": {"url": "https://example.com/"
},
"analytics": [{"name": "people_count",
"parameters": {"roi": {"x": 3327,
"y": 3327,
"width": 3327,
"height": 3327,
"mode": "abs"
},
"rate": {"period": 10,
"unit": "frame"
},
"probe_count": 0,
"people_count_threshold": 1
}
}
]
}

Response samples

Content type

application/json

{"video_data": {"frames_count": 0,
"frame_rate": 0,
"duration": 0
},
"analytics": [{"name": "people_count",
"result": {"crowd": {"events": [{"event_id": "string",
"max_people_count": 0,
"video_segment": {"start_time_offset": 0.123,
"end_time_offset": 1.234,
"start_frame_offset": 15,
"last_frame_offset": 35
},
"frames_estimations": [{"people_count": 0,
"time_offset": 1.234,
"frame_offset": 35
}
]
}
]
}
}
}
]
}

videosdk options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

iso

iso resource

The resource performs a visual examination of frontal type images based on ISO/IEC 19794-5 standard. This means that the images that have passed the validation are standardized and attributes of the person's face meet the established requirements. For more information on the requirements for face attributes in the image, see ISO/IEC 19794-5 Clauses 7-10.

The output JSON contains the result of the check for each estimator. The image check is considered successful if the set of these results complies with the ISO standard.

The order of input images is corresponding to elements order in output JSON. If an image is broken, the resource will return an error for this image and other images will be correctly processed.

Notes for incoming data:

face or body bounding boxes passed with face or body warped image will be ignored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

image_type	integer Default: 0 Enum: 0 1 Image type of input image. 0 - raw image, 1 - face warped image.
multiface_policy	integer (iso_multiface_policy) Default: 0 Enum: 0 1 2 multiple face detection policy: `0` - multiple face detection not allowed `1` - multiple face detection allowed `2` - get only best face detection from the image
extract_exif	integer (extract_exif) Default: 0 Enum: 0 1 Whether to extract EXIF meta information from input JPEG images. Exact output will vary since there are no mandatory requirements for both authoring software and digital cameras how to write the data. This function will only parse the tags and output their names and values as they are. Please refer to JEITA CP-3451 EXIF specification for details.

header Parameters

Accept	string Enum: "application/json" "application/msgpack" Accept request header.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Enum: "application/json" "multipart/form-data" "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64"

Request Body schema:
image/jpeg

string <binary>

Responses

Request samples

Payload
python
python
bash

Content type

image/jpeg

No sample

Response samples

Content type

application/json

Example

check_iso_succeeded

{"images": [{"filename": "raw image",
"status": 1,
"error": {"error_code": 0,
"desc": "Success",
"detail": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"estimations": [{"face": {"detection": {"iso": {"status": 1,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"threshold_value": {"min": 0.2,
"max": 1
},
"result": 1
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "shoulders_position",
"object_value": "parallel",
"threshold_value": ["parallel"
],
"result": 1
}
]
},
"rect": {"x": 108,
"y": 58,
"width": 113,
"height": 165
}
}
}
}
]
}
]
}

iso options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

samples

detect faces

Detect faces in input images, create samples, and estimate face properties.

Detections can be filtered out by head pose. The pose is defined by yaw, pitch and roll angles. To specify a filtering threshold per-angle, use corresponding query parameters (yaw_threshold, pitch_threshold and roll_threshold). By default no filtering is applied.

The estimated face properties are not saved to the Faces database. They are only returned in the response.

Samples are saved in the storage without the ability to disable saving. You can disable the saving of samples only using the handlers.

Notes for incoming data:

face or body bounding boxes passed with face or body warped image will be ignored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

multiface_policy	integer (multiface_policy) Default: 1 Enum: 0 1 2 Multiple face detection policy: `0` - multiple face detection not allowed; `1` - multiple face detection allowed; `2` - get only best face detection from the image.
estimate_head_pose	integer (estimate_head_pose) Default: 0 Enum: 0 1 Whether to estimate head pose in the image. The head pose is represented by pitch, yaw and roll angles. Not supported with warped images (see `warped_image` or `image_type` parameter).
estimate_emotions	integer (estimate_emotions) Default: 0 Enum: 0 1 Whether to estimate emotions in the image. The probability of the following emotions is estimated: "anger", "disgust", "fear", "happiness", "sadness", "surprise", "neutral".
estimate_mask	integer (estimate_mask) Default: 0 Enum: 0 1 Whether to estimate mask in the image. The probability of the following masks states is estimated: "medical_mask", "missing", "occluded". The estimated probability with the highest score is returned in the "predominant mask" parameter.
detect_landmarks68	integer (detect_landmarks68) Default: 0 Enum: 0 1 Whether to detect basic 68-point facial landmarks in the image. Not supported with warped images (see `warped_image` parameter).
extract_exif	integer (extract_exif) Default: 0 Enum: 0 1 Whether to extract EXIF meta information from input JPEG images. Exact output will vary since there are no mandatory requirements for both authoring software and digital cameras how to write the data. This function will only parse the tags and output their names and values as they are. Please refer to JEITA CP-3451 EXIF specification for details.
estimate_quality	integer (estimate_quality) Default: 0 Enum: 0 1 Whether to estimate input face image quality. Each of the following probabilities is estimated: "darkness", "light", "blurriness", "illumination", "specularity". The quality factor is estimated for each probability. It's value is in the range [0..1] where 0 corresponds to low quality and 1 to high quality. Note. Face recognition is not greatly affected by uneven illumination or high specularity.
estimate_gaze	integer (estimate_gaze) Default: 0 Enum: 0 1 Whether to estimate gaze in the image. The gaze is represented by yaw angle and pitch angle for both eyes at once. Not supported with warped images (see `warped_image` or `image_type` parameter).
estimate_eyes_attributes	integer (estimate_eyes_attributes) Default: 0 Enum: 0 1 Whether to estimate eye attributes in the image. The "right_eye" and "left_eye" parameters are estimated, which contain the "state" (opened, closed or occluded) and "iris_landmarks" parameters.
estimate_mouth_attributes	integer (estimate_mouth_attributes) Default: 0 Enum: 0 1 Whether to estimate mouth attributes in the image. Each of the following probabilities is estimated: "opened", "occluded", "smile", "score".
pitch_threshold	integer (pitch_threshold) [ 0 .. 180 ] Example: pitch_threshold=180 Maximum deviation pitch angle from 0. If the estimated value is equal or less than the threshold, the image is filtered. Remove this parameter from the query, or set the parameter value to 180 if pitch angle filtration is not required. When the value is set to "0", all the images are filtered.
roll_threshold	integer (roll_threshold) [ 0 .. 180 ] Example: roll_threshold=180 Maximum deviation roll angle from 0. If the estimated value is equal or less than the threshold, the image is filtered. Remove this parameter from the query, or set the parameter value to 180 if roll angle filtration is not required. When the value is set to "0", all the images are filtered.
yaw_threshold	integer (yaw_threshold) [ 0 .. 180 ] Example: yaw_threshold=180 Maximum deviation yaw angle from 0. If the estimated value is equal or less than the threshold, the image is filtered. Remove this parameter from the query, or set the parameter value to 180 if yaw angle filtration is not required. When the value is set to "0", all the images are filtered.
warped_image	integer (warped_image) Default: 0 Enum: 0 1 Whether an input image is a sample or not.
use_exif_info	integer Default: 1 Enum: 0 1 Example: use_exif_info=1 Whether to try to auto orient image based on EXIF data. The processed image should have EXIF data, otherwise auto orientation will not be performed. Has no effect with tiff images (they're always auto oriented). Ignored with warped images (see `warped_image` or `image_type` parameter).
estimate_face_quality	integer Default: 0 Enum: 0 1 Whether to estimate face quality. It enables you to perform various face quality checks by thresholds which similar to ISO standard. For more information on the requirements for face attributes in the image, see ISO/IEC 19794-5 Clauses 7-10. ⚠ ISO licensing feature is required to be enabled to perform face quality estimation.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "multipart/form-data" "application/json" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64"

Request Body schema:
image/jpeg

string <binary>

Responses

Request samples

Payload
python
python
bash

Content type

image/jpeg

No sample

Response samples

Content type

application/json

Example

head pose, mouth attributes, gaze, quality

{"images": [{"filename": "face_1.jpg",
"error": {"error_code": 0,
"desc": "Success",
"detail": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"status": 1,
"detections": {"samples": [{"face": {"detection": {"rect": {"x": 594,
"y": 181,
"width": 678,
"height": 963
},
"landmarks5": [[169,
169
],
[454,
454
],
[325,
325
],
[227,
227
],
[466,
466
]
],
"quality": {"blurriness": 0.9740276337,
"dark": 0.9211971164,
"illumination": 0.8751303554,
"specularity": 0.9605293274,
"light": 0.8855836391
},
"attributes": {"mouth_attributes": {"opened": 0.021500025,
"occluded": 0.9998804331,
"smile": 0,
"score": 1
},
"head_pose": {"pitch": 6.7033782005,
"roll": -6.140639782,
"yaw": 3.3139002323
},
"gaze": {"yaw": 0.281270504,
"pitch": -1.0716878176
}
}
},
"url": "/6/samples/faces/f9285806-371e-4c61-be00-0424029856e3",
"sample_id": "50cccef8-3ea8-42a0-8e6d-68b90ee148f6"
}
}
],
"filtered_detections": {"face_detections": [ ]
}
}
}
]
}

detector options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

save face/body sample

Save face or body sample to the storage.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

samples_type

required

string

Enum: "faces" "bodies"

Samples type.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/tiff" "image/x-portable-pixmap"

Request Body schema:
image/jpeg

One of

string <binary> (face_sample)

Image generated by VisionLabs algorithms.

Responses

Request samples

python
python
python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/samples/faces"
response = requests.post(url, data=image, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"sample_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/samples/bodies/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

face/body samples options

Get options for the resource.

path Parameters

samples_type

required

string

Enum: "faces" "bodies"

Samples type.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get face/body sample

Get face or body sample by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

samples_type required	string Enum: "faces" "bodies" Samples type.
sample_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/samples/faces"
sampleId = requests.post(url, data=image, headers=headers).json()["sample_id"]

# get sample
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/samples/faces/{sampleId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

check if face/body sample exists

Check if face or body sample with sample_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

samples_type required	string Enum: "faces" "bodies" Samples type.
sample_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/samples/faces"
sampleId = requests.post(url, data=image, headers=headers).json()["sample_id"]

# get sample
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/samples/faces/{sampleId}"
response = requests.head(url, headers=headers)

print(response.status_code)

remove face/body sample

Remove face or body sample by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

samples_type required	string Enum: "faces" "bodies" Samples type.
sample_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/samples/faces"
sampleId = requests.post(url, data=image, headers=headers).json()["sample_id"]

# get sample
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/samples/faces/{sampleId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

face/body sample options

Get options for the resource.

path Parameters

samples_type required	string Enum: "faces" "bodies" Samples type.
sample_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

404
408
500
503
504

Content type

application/json

{"error_code": 13003,
"desc": "Object not found",
"detail": "Image with id '7acc35cf-a3b2-4f87-8d8b-5496a2782d37' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-13003"
}

get sample | previous version Deprecated

Get sample by ID using previous API version.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

check if sample exists | previous version Deprecated

Check if face or body sample with sample_id exists using previous API version.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

remove sample | previous version Deprecated

Remove sample by ID using previous API version.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

sample options | previous version Deprecated

Get options for the resource using previous API version.

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

404
408
500
503
504

Content type

application/json

{"error_code": 13003,
"desc": "Object not found",
"detail": "Image with id '7acc35cf-a3b2-4f87-8d8b-5496a2782d37' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-13003"
}

get sample | legacy Deprecated

Get a face sample by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

check if face sample exists | legacy Deprecated

Check if face sample with sample_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

remove face sample | legacy Deprecated

Remove sample by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

face sample options | legacy Deprecated

Get options for the resource.

path Parameters

sample_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

404
408
500
503
504

Content type

application/json

{"error_code": 13003,
"desc": "Object not found",
"detail": "Image with id '7acc35cf-a3b2-4f87-8d8b-5496a2782d37' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-13003"
}

images

create images

Save images with unique ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/tiff" "image/x-portable-pixmap" Type of transferring image.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
* (X-Luna-Meta-<user_defined_key>)	string Example: <user_defined_value> User-defined image metadata key-value. To store metadata values for multiple keys, the multiple headers should be defined.

Request Body schema:
image/jpeg

string <binary> (binary_image)

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/images"
response = requests.post(url, data=image, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"image_id": "141d2706-8baf-433b-82eb-8c7fada847da",
"url": "/6/images/141d2706-8baf-433b-82eb-8c7fada847da",
"external_url": "http://127.0.0.1:5000/6/images/141d2706-8baf-433b-82eb-8c7fada847da"
}

images options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

check if image exists

Check if image with image_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

image_id

required

string <uuid> (image_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Image ID.

query Parameters

with_meta

integer

Default: 0

Enum: 0 1

Example: with_meta=1

Whether to retrieve user-defined image metadata.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/images"
imageId = requests.post(url, data=image, headers=headers).json()["image_id"]

# get image
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/images/{imageId}"
response = requests.head(url, headers=headers)

print(response.status_code)

delete image

Delete an image.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

image_id

required

string <uuid> (image_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Image ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/images"
imageId = requests.post(url, data=image, headers=headers).json()["image_id"]

# get image
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/images/{imageId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

get image

Receive an origin image.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

image_id

required

string <uuid> (image_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Image ID.

query Parameters

with_meta

integer

Default: 0

Enum: 0 1

Example: with_meta=1

Whether to retrieve user-defined image metadata.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("face_warp.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/images"
imageId = requests.post(url, data=image, headers=headers).json()["image_id"]

# get image
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/images/{imageId}"
response = requests.get(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

image options

Get options for the resource.

path Parameters

image_id

required

string <uuid> (image_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Image ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

objects

create objects

Save object with unique ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type required	string Type of transferring information. WARNING A value of this header will be used as a `Content-Type` header value for requests "GET object" and will be use for a mime type calculation.

Request Body schema: /

string <binary>

Some user defined bytes. The service saves the bytes as is.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "text/plain",
}

url = f"{baseUri}/objects"
response = requests.post(url, data="example", headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"object_id": "141d2706-8baf-433b-82eb-8c7fada847da",
"url": "/6/objects/141d2706-8baf-433b-82eb-8c7fada847da",
"external_url": "http://127.0.0.1:5000/6/objects/141d2706-8baf-433b-82eb-8c7fada847da"
}

objects options

Get options for the resource.

header Parameters

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get object

Receiving objects.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

object_id

required

string <uuid> (object_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Object ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create objects
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "text/plain",
}

url = f"{baseUri}/objects"
objectId = requests.post(url, data="example", headers=headers).json()["object_id"]

# get object
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/objects/{objectId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.text)

Response samples

Content type

application/json

{"error_code": 12017,
"detail": "Bad/incomplete input data",
"desc": "Bad content type",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12017"
}

check if object exists

Check if object with object_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

object_id

required

string <uuid> (object_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Object ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create object
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "text/plain",
}

url = f"{baseUri}/objects"
objectId = requests.post(url, data="example", headers=headers).json()["object_id"]

# check objects
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/objects/{objectId}"
response = requests.head(url, headers=headers)

print(response.status_code)

delete object

Delete object

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

object_id

required

string <uuid> (object_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Object ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create object
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "text/plain",
}

url = f"{baseUri}/objects"
objectId = requests.post(url, data="example", headers=headers).json()["object_id"]

# get object
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/objects/{objectId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

object options

Get options for the resource.

path Parameters

object_id

required

string <uuid> (object_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Object ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

attributes

extract attributes

Extract descriptors and basic attributes from samples.

All the extracted attributes are temporary.

Temporary attributes have a TTL (time to live) and will be removed from the database after the specified period.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

score_threshold	number (score_threshold) [ 0 .. 1 ] Default: 0 Example: score_threshold=0.7 Descriptor quality score threshold. The higher the quality score for the image, the better the extraction results. All the attributes with a quality score below the threshold will be ignored (and not stored in the DB). The function will proceed as usual with all the remaining descriptors (if left). Consult VisionLabs about the recommended value of this parameter. Note! This parameter is not related to the image quality estimated in the detect request (`estimate_quality` request parameter).
extract_descriptor	integer (extract_descriptor) Default: 1 Enum: 0 1 Example: extract_descriptor=1 Whether to extract face descriptor(s).
extract_basic_attributes	integer (extract_basic_attributes) Default: 0 Enum: 0 1 Whether to extract basic attributes (gender, age, ethnicity).
aggregate_attributes	integer (aggregate_attributes) Whether to aggregate face attributes (descriptor and basic attributes). Aggregation will only be performed together with the `extract_descriptor` and/or `extract_basic_attributes` parameters. If set, all extracted attributes from each image will be aggregated and stored as single objects. Otherwise, all extracted attributes from each image will be stored for each sample as separate objects.
ttl	integer [ 1 .. 86400 ] Default: 300 Lifetime for temporary attribute (seconds).

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

Array ([ 1 .. 8 ] items)

string <uuid> (sample_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Sample ID.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

["f9f03668-27e3-4e23-9b55-681e5927905e",
"4967ccb7-b521-43b5-93ba-a0d266631bb2",
"dd98cf9c-ddf3-4962-a3c5-e8bd540a4fc7"
]

Response samples

Content type

application/json

Example

all fields specified without aggregating attributes

[{"samples": ["f9f03668-27e3-4e23-9b55-681e5927905e"
],
"attribute_id": "3917e7a6-2f62-4151-905a-a5d786fcaf0b",
"url": "/6/attributes/3917e7a6-2f62-4151-905a-a5d786fcaf0b",
"external_url": "http://127.0.0.1:5000/6/attributes/3917e7a6-2f62-4151-905a-a5d786fcaf0b",
"basic_attributes": {"ethnicities": {"predominant_ethnicity": "caucasian",
"estimations": {"asian": 9.823425273225439e-8,
"indian": 0.000015799123502802104,
"caucasian": 0.9999819993972778,
"african_american": 0.000002058620793832233
}
},
"age": 19,
"gender": 0
},
"score": 0.9949966669082642
},
{"samples": ["4967ccb7-b521-43b5-93ba-a0d266631bb2"
],
"attribute_id": "87737317-9c75-46b3-a0cc-6cd2b258e027",
"url": "/6/attributes/87737317-9c75-46b3-a0cc-6cd2b258e027",
"external_url": "http://127.0.0.1:5000/6/attributes/87737317-9c75-46b3-a0cc-6cd2b258e027",
"basic_attributes": {"ethnicities": {"predominant_ethnicity": "caucasian",
"estimations": {"asian": 0.000002390194367762888,
"indian": 1.3357706052374851e-8,
"caucasian": 0.9999673366546631,
"african_american": 0.000030240154956118204
}
},
"age": 23,
"gender": 0
},
"score": 0.998572826385498
},
{"samples": [ ],
"attribute_id": null,
"url": null,
"external_url": null,
"filter": {"is_filtered": true,
"filter_reasons": [{"filter_name": "score_threshold",
"object_value": 0.8610286712646484,
"threshold_value": 0.9
}
]
}
}
]

extractor options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

create temporary attribute

New temporary attributes creation.

Note. Use this request when you need to add basic attributes or descriptors from external storage. Otherwise, use the extract attributes request.

All the extracted attributes are temporary.

Temporary attributes have a TTL (time to live) and will be removed from the database after the specified period.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

ttl	integer [ 1 .. 86400 ] Default: 300 Lifetime for temporary attribute (seconds).

header Parameters

Content-Type	string Enum: "application/json" "multipart/form-data" Content type is `application/json` or `multipart/form-data`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Request Body schema:
application/json

One of

required	Array of descriptor_data (object) or raw_descriptor_base64 (string) (face_descriptors) non-empty List of descriptors with versions. Each descriptor is aggregated from the provided samples.
face_descriptor_samples	Array of strings <uuid> (attributes_samples) >= 0 items unique Default: [] List of uniqie sample IDs which are resources for the estimated attributes. WARNING: if the user does not set any attributes samples, faces with such attributes will be skipped during the process of updating attributes using new estimation algorithm.
required	object (basic_attributes_without_defaults) Basic attributes.
basic_attributes_samples	Array of strings <uuid> (attributes_samples) >= 0 items unique Default: [] List of uniqie sample IDs which are resources for the estimated attributes. WARNING: if the user does not set any attributes samples, faces with such attributes will be skipped during the process of updating attributes using new estimation algorithm.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

attribute_with_descriptors_and_basic_attributes

{"face_descriptors": [{"descriptor": "2xQ2gprbMUePw1s9gw9fvA==",
"version": 46
},
{"descriptor": "1xWqdsdwew32fsdsdw1s9gw9fvA==",
"version": 56
}
],
"face_descriptor_samples": ["ee4c42b6-23ae-410e-a2aa-a4220e64ba4b",
"e909cfbe-29d3-44ed-a949-6cb700b89eba"
],
"basic_attributes": {"age": 29,
"gender": 0,
"ethnicity": 4
},
"basic_attributes_samples": ["ee4c42b6-23ae-410e-a2aa-a4220e64ba4b",
"e909cfbe-29d3-44ed-a949-6cb700b89eba"
]
}

Response samples

Content type

application/json

{"attribute_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/attributes/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/attributes/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

get temporary attributes

Get temporary attributes by IDs.

For each attribute:

If the attribute TTL has not expired, the attribute data is returned.
If the TTL has expired, no data is returned for this attribute in the response.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

attribute_ids required	string <list of uuid> Comma-separated list of attribute IDs.
account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
targets	string <comma-separated items> Default: "create_time, attribute_id, account_id, face_descriptor_samples, basic_attributes_samples, face_descriptor, basic_attributes_samples" Example: targets=basic_attributes,basic_attributes_samples,account_id Comma-separated list of temporary attributes targets. All targets are available by default.
descriptor_version	integer (descriptor_version) Enum: 46 52 54 56 57 58 59 60 Example: descriptor_version=56 Descriptor version returned in the response. By default, the LUNA PLATFORM default descriptor version is used.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create attribute
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 0,
        "ethnicity": 3,
    },
}

url = f"{baseUri}/attributes"
attributeId = requests.post(url, json=payload, headers=headers).json()["attribute_id"]

# get attributes
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

params = {
    "attribute_ids": [
        attributeId,
    ],
    "targets": "basic_attributes,basic_attributes_samples,account_id",
}

url = f"{baseUri}/attributes"
response = requests.get(
    url, headers=headers, params=params
)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

Example

default (full)

{"attributes": [{"create_time": "2021-08-11T14:57:18.416928+03:00",
"attribute_id": "7fdf9225-3c06-4c21-b774-8bea99bcce20",
"account_id": "0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"face_descriptor_samples": ["0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"2f1cbb34-12e5-486c-8f7f-57273053c32d"
],
"basic_attributes_samples": ["00000000-0000-4000-8000-000000000000"
],
"face_descriptor": "2xQ2gprbMUePw1s9gw9fvA==",
"basic_attributes": {"age": 33,
"gender": 1,
"ethnicity": 3
}
}
]
}

temporary attributes options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get temporary attribute

Get temporary attribute by ID.

If the attribute TTL has not expired, the attribute data is returned.

Otherwise, the "Attributes not found" error is returned.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

query Parameters

descriptor_version	integer (descriptor_version) Enum: 46 52 54 56 57 58 59 60 Example: descriptor_version=56 Descriptor version returned in the response. By default, the LUNA PLATFORM default descriptor version is used.
targets	string <comma-separated items> Default: "create_time, attribute_id, account_id, face_descriptor_samples, basic_attributes_samples, face_descriptor, basic_attributes_samples" Example: targets=basic_attributes,basic_attributes_samples,account_id Comma-separated list of temporary attributes targets. All targets are available by default.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create attribute
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 1,
        "ethnicity": 3,
    },
}

url = f"{baseUri}/attributes"
attributeId = requests.post(url, json=payload, headers=headers).json()["attribute_id"]

# get attributes
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/attributes/{attributeId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

Example

default (full)

{"create_time": "2021-08-11T14:57:18.416928+03:00",
"attribute_id": "7fdf9225-3c06-4c21-b774-8bea99bcce20",
"account_id": "0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"face_descriptor_samples": ["0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"2f1cbb34-12e5-486c-8f7f-57273053c32d"
],
"basic_attributes_samples": ["00000000-0000-4000-8000-000000000000"
],
"face_descriptor": "2xQ2gprbMUePw1s9gw9fvA==",
"basic_attributes": {"age": 33,
"gender": 1,
"ethnicity": 3
}
}

check temporary attribute

Check if temporary attribute with attribute_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

query Parameters

descriptor_version	integer (descriptor_version) Enum: 46 52 54 56 57 58 59 60 Example: descriptor_version=56 Descriptor version returned in the response. By default, the LUNA PLATFORM default descriptor version is used.
targets	string <comma-separated items> Default: "create_time, attribute_id, account_id, face_descriptor_samples, basic_attributes_samples, face_descriptor, basic_attributes_samples" Example: targets=basic_attributes,basic_attributes_samples,account_id Comma-separated list of temporary attributes targets. All targets are available by default.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create attribute
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 1,
        "ethnicity": 3,
    },
}

url = f"{baseUri}/attributes"
attributeId = requests.post(url, json=payload, headers=headers).json()["attribute_id"]

# get attributes
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/attributes/{attributeId}"
response = requests.head(url, headers=headers)

print(response.status_code)

delete attribute

Delete the attribute by its ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

# create attribute
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 1,
        "ethnicity": 3,
    },
}

url = "http://127.0.0.1:5000/6/attributes"
attributeId = requests.post(url, json=payload, headers=headers).json()["attribute_id"]

# get attributes
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"http://127.0.0.1:5000/6/attributes/{attributeId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

temporary attributes attribute options

Get options for the resource.

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get temporary attribute samples

Get all the temporary attribute samples by the attribute ID.

If the attribute TTL has not expired, the attribute data is returned.

Otherwise, the "Attributes not found" error is returned.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("image.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/detector"
sampleId = requests.post(url, data=image, headers=headers).json()["images"][0]["detections"]["samples"][0]["face"]["sample_id"]

# exreact attr
# create attribute
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 1,
        "ethnicity": 3,
    },
    "basic_attributes_samples": [
        sampleId,
    ],
}

url = f"{baseUri}/attributes"
attributeId = requests.post(url, json=payload, headers=headers).json()["attribute_id"]

# get attributes by id
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/attributes/{attributeId}/samples"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"samples": ["0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"2f1cbb34-12e5-486c-8f7f-57273053c32d"
]
}

temporary attribute samples options

Get options for the resource.

path Parameters

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the temporary attribute.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

faces

create face

Create a face.

The face can be attached to one or several lists.

You can create new face using a temporary attribute ID or using external attribute data (descriptors and/or basic attributes).

You can also create the face without any attributes specified.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "application/json" "application/msgpack" Format of a request body data.

Request Body schema:
application/json

	attribute_set_by_attribute_id (object) or (attribute_no_account (attribute_with_descriptors_and_basic_attributes_no_account (object) or attribute_with_basic_attributes_no_account (object) or attribute_with_descriptors_no_account (object))) (face_attribute) Face attributes. You can specify attributes for the face using one of several ways: by specifying the attribute ID of a temporary attribute by specifying descriptors and basic attributes (with or without samples) by specifying descriptors (with or without samples) by specifying basic attributes (with or without samples) The last three ways are used when you need to create the face using data stored in external storage.
external_id	string (face_external_id) <= 36 characters Default: "" User-defined external ID for the face. External ID can be used to link several faces which belong to one person.
user_data	string (face_user_data) <= 128 characters Default: "" User data associated with face.
avatar	string <uri-reference> (avatar) <= 256 characters Default: "" Avatar is a visual representation of the face. The avatar can be used in the user interface. You can use a sample or an external image as the avatar.
lists	Array of strings <uuid> (list_id) non-empty Lists for linking face with them.
event_id	string <uuid> (event_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... The event ID associated with the face creation.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

create face using attribute ID

{"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"attribute": {"attribute_id": "b4a40d88-8998-4e19-8cc8-be894a1ceb5e"
},
"user_data": "some_string",
"lists": ["234fc28c-a767-42fc-a0c2-e01ad00b5c59",
"c2a09aff-0116-41cf-a7c7-91631d40d0c2"
],
"avatar": "https://upload.wikimedia.org/wikipedia/commons/thumb/2/2d/Yfke-sturm-1326186044.jpg/800px-Yfke-sturm-1326186044.jpg",
"event_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
}

Response samples

Content type

application/json

{"face_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/faces/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/faces/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

get faces

Get faces according to filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for object create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for object create_time.
event_id	string <uuid> (event_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: event_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Event ID associated with the face creation.
face_id__lt	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: face_id__lt=8950722f-3fd4-4223-b48f-03f95f0e8dfb Face ID upper excluded bound. Faces in response will be sorted by their ids. If neither face_id__lt or face_id__gte is specified, the faces will be sorted by creation time.
face_id__gte	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: face_id__gte=8950722f-3fd4-4223-b48f-03f95f0e8dfb Face ID lower included bound. Faces in response will be sorted by their ids. If neither face_id__lt or face_id__gte is specified, the faces will be sorted by creation time.
face_ids	string <list of uuid> Example: face_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of face IDs.
external_ids	string Example: external_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of external IDs.
user_data	string Example: user_data=user_data_text Find all objects with `user_data` similar to this parameter. You can specify only part of the `user_data` value for this filter.
list_id	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: list_id=557d54ec-29ad-4f3c-93b4-c9092ef12515 List ID that contains faces.
targets	Array of strings (faces_targets) Items Enum: "face_id" "account_id" "event_id" "user_data" "create_time" "external_id" "avatar" "lists" Example: targets=face_id,user_data Comma-separated list of face fields. If set, each face from result will contain only specified fields, otherwise, faces with all the fields will be returned.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces"
params = {
    "create_time__gte": "2018-08-11T09:11:41.674Z",
    "user_data": "face",
    "targets": "face_id,account_id,event_id,user_data,create_time",
}

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"faces": [{"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
]
}
]
}

delete faces

Delete several faces by IDs.

When the faces are removed, attributes (descriptors and basic attributes) linked to the faces are deleted. Samples linked to the faces are not deleted.

If you need to delete faces according to some filters and with all samples, you can use the "garbage collection task" with target = faces and remove_samples flag enabled.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

ignore

integer (int01)

Default: 0

Enum: 0 1

Whether to ignore the error if the face to be deleted does not exist.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

face_ids

required

Array of strings <uuid> (face_id) non-empty

Comma-separated list of face IDs for removal.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"face_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
]
}

Response samples

Content type

application/json

{"error_code": 12022,
"desc": "Bad/incomplete input data",
"detail": "Failed to validate input json. Path: '',  message: 'Additional properties are not allowed ('faces' was unexpected)'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12022"
}

faces options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get face count

Count faces according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for object create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for object create_time.
face_ids	string <list of uuid> Example: face_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of face IDs.
face_id__lt	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: face_id__lt=8950722f-3fd4-4223-b48f-03f95f0e8dfb Face ID upper excluded bound
face_id__gte	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: face_id__gte=8950722f-3fd4-4223-b48f-03f95f0e8dfb Face ID lower included bound
event_id	string <uuid> (event_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: event_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Event ID associated with the face creation.
external_ids	string Example: external_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of external IDs.
user_data	string Example: user_data=user_data_text Find all objects with `user_data` similar to this parameter. You can specify only part of the `user_data` value for this filter.
list_id	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: list_id=557d54ec-29ad-4f3c-93b4-c9092ef12515 List ID that contains faces.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/count"
params = {
    "create_time__gte": "2018-08-11T09:11:41.674Z",
    "user_data": "face",
}
response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"faces_count": 7
}

faces count options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get count of faces with attributes

Count faces with attributes.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/attributes/count"

response = requests.get(
    url,
    headers=headers,
)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"faces_count": 7
}

get count of faces with attributes options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get face

Get face by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

query Parameters

targets

Array of strings (faces_targets)

Items Enum: "face_id" "account_id" "event_id" "user_data" "create_time" "external_id" "avatar" "lists"

Example: targets=face_id,user_data

Comma-separated list of face fields. If set, each face from result will contain only specified fields, otherwise, faces with all the fields will be returned.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces"
faceId = requests.post(url, headers=headers).json()["face_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/faces/{faceId}"
response = requests.get(
    url,
    headers=headers,
)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
]
}

patch face

Update face fields: user_data, external_id, event_id, avatar.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

external_id	string <= 36 characters User-defined external ID for the face.
event_id	string or null <uuid> (event_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Event ID.
user_data	string <= 128 characters User data associated with face.
avatar	string <uri-reference> (avatar) <= 256 characters Default: "" Avatar is a visual representation of the face. The avatar can be used in the user interface. You can use a sample or an external image as the avatar.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"user_data": "some_string",
"avatar": "https://upload.wikimedia.org/wikipedia/commons/7/7f/Emma_Watson_2013.jpg"
}

Response samples

Content type

application/json

{"error_code": 12022,
"desc": "Bad/incomplete input data",
"detail": "Failed to validate input json. Path: '',  message: 'Additional properties are not allowed ('userdata' was unexpected)'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12022"
}

remove face

Remove face by ID.

When the face is removed, attributes (descriptors and basic attributes) linked to the face are deleted. Samples linked to the face are not deleted. If there are a small number of samples for face, then you can use the resources "get face attribute samples" > "remove face/body sample" > "delete face" (this resource). If you need to delete faces according to some filters and with all samples, you can use the "garbage collection task" with target = faces and remove_samples flag enabled.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}
url = f"{baseUri}/faces"
faceId = requests.post(
    url,
    headers=headers,
).json()["face_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/{faceId}"
response = requests.delete(
    url,
    headers=headers,
)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

check if face exists

Check if face with face_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

query Parameters

targets

Array of strings (faces_targets)

Items Enum: "face_id" "account_id" "event_id" "user_data" "create_time" "external_id" "avatar" "lists"

Example: targets=face_id,user_data

Comma-separated list of face fields. If set, each face from result will contain only specified fields, otherwise, faces with all the fields will be returned.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces"
faceId = requests.post(
    url,
    headers=headers,
).json()["face_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/{faceId}"
response = requests.head(
    url,
    headers=headers,
)

print(response.status_code)

face options

Get options for the resource.

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

face attributes

put face attribute

Put face attribute.

This request changes all the attribute data corresponding to the specified face.

The attribute can be specified by temporary attribute ID or using external attribute data (descriptors and/or basic attributes).

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

One of

attribute_id

required

string <uuid> (attribute_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Attribute ID. This ID links the descriptor, basic attributes, and samples extracted from a single image.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

put face attribute specified by attribute ID

{"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}

Response samples

Content type

application/json

Example

bad_json

{"error_code": 12022,
"desc": "Bad/incomplete input data",
"detail": "Failed to validate input json. Path: '',  message: 'Additional properties are not allowed ('userdata' was unexpected)'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12022"
}

get face attribute

Get face attribute by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

query Parameters

targets	string <comma-separated items> Default: "create_time,basic_attributes,basic_attributes_samples,face_descriptor,face_descriptor_samples" Comma-separated list of temporary attributes targets. Available targets: `create_time`, `basic_attributes`, `basic_attributes_samples`, `face_descriptor`, `face_descriptor_samples`.
descriptor_version	integer (descriptor_version) Enum: 46 52 54 56 57 58 59 60 Example: descriptor_version=56 Descriptor version returned in the response. By default, the LUNA PLATFORM default descriptor version is used.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import base64

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("image.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/detector"
sampleId = requests.post(url, data=image, headers=headers).json()["images"][0]["detections"]["samples"][0]["face"]["sample_id"]

# create attribute
with open("descriptor56", "rb") as file:
    descriptor = base64.b64encode(file.read()).decode()

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
params = {
    "ttl": 600,
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 0,
        "ethnicity": 3,
    },
    "basic_attributes_samples": [
        sampleId,
    ],
    "face_descriptor_samples": [
        sampleId,
    ],
    "face_descriptors": [
        {"descriptor": descriptor, "version": 56},
    ],
}
url = f"{baseUri}/attributes"
attributeId = requests.post(
    url, json=payload, headers=headers, params=params
).json()["attribute_id"]

# create face
payload = {
    "external_id": "2xQ2gprbMUePw1s9gw9fvA==",
    "attribute": {"attribute_id": attributeId},
}
headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}
url = f"{baseUri}/faces"
faceId = requests.post(
    url,
    headers=headers,
    json=payload,
).json()["face_id"]

# get face attribute by ID
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/{faceId}/attributes"
response = requests.get(
    url,
    headers=headers,
)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"attributes": {"create_time": "2018-08-11T09:11:41.674Z",
"basic_attributes": {"age": 29,
"gender": 1,
"ethnicity": 2
},
"face_descriptor": {"descriptor": "byte string",
"descriptor_version": 56
},
"basic_attributes_samples": ["ee4c42b6-23ae-410e-a2aa-a4220e64ba4b",
"e909cfbe-29d3-44ed-a949-6cb700b89eba"
],
"face_descriptor_samples": ["951de511-7ef5-4ed9-9c06-dcfbb399712e",
"3c3a83c2-c21e-4855-91b5-34e6b63fb12d"
]
}
}

delete face attribute

Remove face attribute by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import base64

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}
with open("image.jpg", "rb") as image_file:
    image = image_file.read()
url = f"{baseUri}/detector"
sampleId = requests.post(url, data=image, headers=headers).json()["images"][0]["detections"]["samples"][0]["face"]["sample_id"]

# create attribute
with open("descriptor56", "rb") as file:
    descriptor = base64.b64encode(file.read()).decode()

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
params = {
    "ttl": 600,
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 0,
        "ethnicity": 3,
    },
    "basic_attributes_samples": [
        sampleId,
    ],
    "face_descriptor_samples": [
        sampleId,
    ],
    "face_descriptors": [
        {"descriptor": descriptor, "version": 56},
    ],
}
url = f"{baseUri}/attributes"
attributeId = requests.post(
    url, json=payload, headers=headers, params=params
).json()["attribute_id"]

payload = {
    "external_id": "2xQ2gprbMUePw1s9gw9fvA==",
    "attribute": {"attribute_id": attributeId},
}

# create face
headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}
url = f"{baseUri}/faces"
faceId = requests.post(
    url,
    headers=headers,
    json=payload,
).json()["face_id"]

# get face attribute by ID
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/{faceId}/attributes"
response = requests.delete(
    url,
    headers=headers,
)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

faces attributes options

Get options for the resource.

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get face attribute samples

Get face attribute samples by face ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import base64

baseUri = "http://127.0.0.1:5000/6"

# create sample
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
}

with open("image.jpg", "rb") as image_file:
    image = image_file.read()

url = f"{baseUri}/detector"
sampleId = requests.post(url, data=image, headers=headers).json()["images"][0]["detections"]["samples"][0]["face"]["sample_id"]

# create attribute
with open("descriptor56", "rb") as file:
    descriptor = base64.b64encode(file.read()).decode()

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
params = {
    "ttl": 600,
}
payload = {
    "basic_attributes": {
        "age": 29,
        "gender": 0,
        "ethnicity": 3,
    },
    "basic_attributes_samples": [
        sampleId,
    ],
    "face_descriptor_samples": [
        sampleId,
    ],
    "face_descriptors": [
        {"descriptor": descriptor, "version": 56},
    ],
}
url = f"{baseUri}/attributes"
attributeId = requests.post(
    url, json=payload, headers=headers, params=params
).json()["attribute_id"]

# create face
payload = {
    "external_id": "2xQ2gprbMUePw1s9gw9fvA==",
    "attribute": {"attribute_id": attributeId},
}
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces"
faceId = requests.post(
    url,
    headers=headers,
    json=payload,
).json()["face_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/faces/{faceId}/attributes/samples"
response = requests.get(
    url,
    headers=headers,
)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"samples": ["0d1cc36e-d719-4f54-8abe-4e5e0cb1f43c",
"2f1cbb34-12e5-486c-8f7f-57273053c32d"
]
}

faces attributes samples options

Get options for the resource.

path Parameters

face_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the face (face_id received in the "create face" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

lists

create list

Create a list.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

user_data

string (list_user_data) <= 128 characters

Default: ""

User data associated with list.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"user_data": "list of good persons"
}

Response samples

Content type

application/json

{"list_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/lists/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/lists/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

get lists

Get lists according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for list create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for list create_time.
last_update_time__lt	string <date-time> (time) Example: last_update_time__lt=2018-08-11T09:11:41.674Z Upper excluded bound for list last_update_time.
last_update_time__gte	string <date-time> (time) Example: last_update_time__gte=2018-08-11T09:11:41.674Z Lower included bound for list last_update_time.
user_data	string Example: user_data=user_data_text Find all objects with `user_data` similar to this parameter. You can specify only part of the `user_data` value for this filter.
user_data__eq	string Example: user_data__eq=user_data_text Find all objects with same `user_data`.
list_ids	string <list of uuid> Comma-separated list of list IDs.
list_id__lt	string <uuid> List ID upper excluding boundary.
list_id__gte	string <uuid> List ID lower including boundary.
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

params = {
    "user_data": "good",
    "page_size": 20,
    "create_time__gte": "2020-10-10T09:11:41.674Z",
}
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists"
response = requests.get(url, params=params, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"lists": [{"list_id": "c004aae2-f191-4a1a-9d2a-e5894f8cecbf",
"user_data": "good guys",
"account_id": "c004aae2-f191-4a1a-9d2a-e5894f8cecbf",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
},
{"list_id": "a30f4c1d-976e-439b-82ce-16b99779f906",
"account_id": "c004aae2-f191-4a1a-9d2a-e5894f8cecbf",
"user_data": "",
"create_time": "2021-06-18T21:50:40.953301+03:00",
"last_update_time": "2021-06-18T21:50:40.953301+03:00"
}
]
}

delete lists

Delete several lists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

with_faces

integer (int01)

Default: 0

Enum: 0 1

Whether to delete list with all its faces.

header Parameters

Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

list_ids

required

Array of strings <uuid> (list_id) non-empty

Comma-separated list of list IDs for removal.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"list_ids": ["string"
]
}

Response samples

Content type

application/json

{"error_code": 12022,
"desc": "Bad/incomplete input data",
"detail": "Failed to validate input json. Path: '',  message: 'Additional properties are not allowed ('faces' was unexpected)'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12022"
}

lists options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get list count

Count lists according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
user_data	string Example: user_data=user_data_text Find all objects with `user_data` similar to this parameter. You can specify only part of the `user_data` value for this filter.
user_data__eq	string Example: user_data__eq=user_data_text Find all objects with same `user_data`.
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for list create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for list create_time.
last_update_time__lt	string <date-time> (time) Example: last_update_time__lt=2018-08-11T09:11:41.674Z Upper excluded bound for list last_update_time.
last_update_time__gte	string <date-time> (time) Example: last_update_time__gte=2018-08-11T09:11:41.674Z Lower included bound for list last_update_time.
list_ids	string <list of uuid> Comma-separated list of list IDs.
list_id__lt	string <uuid> List ID upper excluding boundary.
list_id__gte	string <uuid> List ID lower including boundary.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# get list according to the filters
params = {
    "user_data": "good",
    "create_time__gte": "2020-10-10T09:11:41.674Z",
    "last_update_time__gte": "2020-10-10T09:11:41.674Z",
}
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists/count"
response = requests.get(url, params=params, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"lists_count": 3
}

lists count options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get list

Get list by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists"
listId = requests.post(url, headers=headers).json()["list_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists/{listId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"list_id": "c004aae2-f191-4a1a-9d2a-e5894f8cecbf",
"user_data": "good guys",
"account_id": "c004aae2-f191-4a1a-9d2a-e5894f8cecbf",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}

check if list exists

Check if list with list_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists"
listId = requests.post(url, headers=headers).json()["list_id"]

# check list
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists/{listId}"
response = requests.head(url, headers=headers)

print(response.status_code)
print(response.json())

update list

Update the user_data field of the list.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

user_data

string <= 128 characters

User data associated with list.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"user_data": "list of good persons"
}

Response samples

Content type

application/json

Example

bad_content_type

{"error_code": 12017,
"desc": "Bad/incomplete input data",
"detail": "Bad content type",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12017"
}

delete list

Delete list by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

query Parameters

with_faces

integer (int01)

Default: 0

Enum: 0 1

Whether to delete list with all its faces.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# create list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/lists"
listId = requests.post(url, headers=headers).json()["list_id"]

# delete list
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
params = {"with_faces": 1}
url = f"{baseUri}/lists/{listId}"
response = requests.delete(url, params=params, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

list options

Get options for the resource.

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

attach/detach faces to the list

Attach or detach faces to the list.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

action required	string Enum: "attach" "detach" Expected action with list and faces.
face_ids required	Array of strings <uuid> (face_id) non-empty Faces to attach or detach to/from list.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"action": "attach",
"face_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
]
}

Response samples

Content type

application/json

Example

bad_content_type

{"error_code": 12017,
"desc": "Bad/incomplete input data",
"detail": "Bad content type",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12017"
}

link options

Get options for the resource.

path Parameters

list_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

List ID (list_id received in the "create list" request).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

matcher

matching faces

Performs matching of given references with given candidates.

Note! Descriptors must be extracted for reference(s) and candidate(s). Objects without descriptors cannot be matched.

The sources for candidates are faces, attributes and events. See the "compare two faces using their IDs", "compare two events using their IDs", and "compare events using filters" examples.

You can specify the "list_id" filter of the "faces" candidate to perform matching by the specified list. See the "search by list and creation time" examples.

The sources for references are faces, events, attributes, external IDs of faces, or descriptors (raw, SDK format, or binary XPK format).

Matching results are returned for the candidates that correspond to the specified filters. If none of the candidates corresponds to the filters (for example, a non-existent ID is set in the "event_ids" field or the "face_ids" field), there will be no matching result and no error returned. The result field will be empty. See the "nonexistent references errors" examples.

If a non-existent reference is set (for example, a non-existent ID is set in the "event_id" field or the "face_id" field), the corresponding error is returned. See the "no ID for reference face found" response example.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Content-Type	string Enum: "application/json" "application/msgpack" Format of a request body data.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Accept	string Default: application/json Enum: "application/json" "application/msgpack" Determines response mime-type which client to expect.

Request Body schema:
application/json

required	Array of candidate_face (object) or candidate_event (object) or candidate_attribute (object) [ 0 .. 30 ] items Candidates for matching.
required	Array of any [ 1 .. 30 ] items References for matching. Each reference is matched with all given candidates. You can specify one or several references of one or several types.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

compare two faces using their IDs

{"candidates": [{"filters": {"origin": "faces",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"external_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12550"
],
"user_data": "some_string",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2022-08-11T09:11:41.674Z",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "557d54ec-29ad-4f3c-93b4-c9092ef12519",
"list_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
},
"limit": 3,
"targets": ["face_id",
"account_id",
"event_id",
"user_data",
"create_time",
"external_id",
"lists",
"similarity"
],
"threshold": 0.01
}
],
"references": [{"type": "face",
"id": "35229c93-85f8-44f3-ab30-3248d7051af9"
}
]
}

Response samples

Content type

application/json

Example

compare two faces using their IDs

[{"reference": {"id": "a68f5995-766d-4a27-889a-35e373d0f0b2",
"type": "face"
},
"matches": [{"result": [{"face": {"face_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"event_id": null,
"user_data": "some_string",
"create_time": "2020-08-13T18:12:20.469171+03:00",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"lists": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
]
},
"similarity": 0.9
}
],
"filters": {"origin": "faces",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"external_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12550"
],
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"user_data": "some_string",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2022-08-11T09:11:41.674Z",
"face_id__gte": "000d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "557d54ec-29ad-4f3c-93b4-c9092ef12519",
"list_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
}
]
}
]

matcher options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

human body matching

Matcher API allows to submit tasks to a service that searches for human bodies similar to a given reference(s) by matching them. A body attribute descriptor should be extracted for reference(s) and candidate(s).

The sources for references are events or binary descriptor. The sources for candidates is events.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Content-Type	string Enum: "application/json" "application/msgpack" Format of a request body data.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Accept	string Default: application/json Enum: "application/json" "application/msgpack" Determines response mime-type which client to expect.

Request Body schema:
application/json

required	Array of any [ 1 .. 30 ] items References for matching. Each reference is matched with all given candidates. You can specify one or several references of one or several types.
required	Array of objects (candidate_event) [ 1 .. 30 ] items Candidates for matching.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"references": [{"type": "event",
"id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"candidates": [{"filters": {"origin": "events",
"event_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"account_id": "string",
"event_id__gte": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"event_id__lt": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"handler_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"external_ids": ["14159261415926"
],
"top_matching_candidates_label": "good guys",
"top_similar_object_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"top_similar_external_ids": ["14159261415926"
],
"top_similar_object_similarity__gte": 0.5,
"top_similar_object_similarity__lt": 0.5,
"age__gte": 22,
"age__lt": 30,
"gender": 1,
"emotions": [4,
7
],
"liveness": 1,
"deepfake": 1,
"masks": [1
],
"ethnic_groups": [4,
3
],
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"user_data": "info",
"sources": ["cam1",
"cam2",
null
],
"stream_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"tags": ["tag1",
"tag2"
],
"cities": ["moscow",
"New-York",
null
],
"areas": ["area1",
"area2",
null
],
"districts": ["mitino",
"central park",
null
],
"streets": ["arbat, schepkina",
null
],
"house_numbers": ["1",
"1/2str3",
null
],
"geo_position": {"origin_longitude": 36.616,
"origin_latitude": 55.752,
"longitude_delta": 0.01,
"latitude_delta": 0.01
},
"track_ids": ["track_id_number_1",
"track_id_number_2",
null
],
"apparent_gender": [1
],
"apparent_age__gte": 50,
"apparent_age__lt": 50,
"headwear_states": [1
],
"headwear_apparent_colors": ["black"
],
"sleeve_lengths": ["short"
],
"upper_clothing_colors": ["black",
"white"
],
"lower_garment_colors": ["black",
"white"
],
"lower_garment_types": ["trousers"
],
"shoes_apparent_colors": ["black"
],
"backpack_states": [1
],
"meta": {"user.age__gt": 18
},
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"end_time__gte": "2018-08-11T09:11:41.674Z",
"end_time__lt": "2018-08-11T09:11:41.674Z"
},
"order": "similarity",
"limit": 3,
"targets": ["event_id"
],
"threshold": 0.5
}
]
}

Response samples

Content type

application/json

Example

compare events using filters

[{"reference": {"id": "a68f5995-766d-4a27-889a-35e373d0f0b2",
"type": "event"
},
"matches": [{"result": [{"similarity": 0.5,
"event": {"create_time": "2018-08-11T09:11:41.674Z",
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"handler_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"external_id": "14159261415926",
"source": "Main_hall_camera",
"stream_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"top_match": {"face_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"similarity": 0.6,
"label": "good guys",
"external_id": "external_id_1"
},
"match_result": [{"candidates": [{"event": {"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": null,
"user_data": "user data",
"handler_id": null,
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"source": "cam_1"
},
"similarity": 0.5
}
],
"label": "good guy"
}
],
"face_detections": [{"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"body_detections": [{"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"face_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"attach_result": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"gender": 1,
"age": 29,
"emotion": 1,
"mask": 1,
"ethnic_group": 4,
"tags": ["tag1",
"tag2"
],
"user_data": "info",
"location": {"city": "Moscow",
"area": "string",
"district": "string",
"street": "Lenina",
"house_number": "3",
"geo_position": {"longitude": -63.9,
"latitude": 40.7
}
},
"track_id": "useful_track_id_number_1"
}
}
],
"filters": {"origin": "events",
"event_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"event_id__gte": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"event_id__lt": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"handler_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"external_ids": ["14159261415926"
],
"top_matching_candidates_label": "good guys",
"top_similar_object_ids": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"top_similar_external_ids": ["external_id_1"
],
"top_similar_object_similarity__gte": 0.5,
"top_similar_object_similarity__lt": 0.5,
"age__gte": 22,
"age__lt": 30,
"gender": 1,
"emotions": [4,
7
],
"masks": [2,
3
],
"ethnic_groups": [4,
3
],
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"user_data": "user info",
"sources": ["cam1",
"cam2"
],
"tags": ["tag1",
"tag2"
],
"cities": ["Moscow",
"New-York"
],
"areas": ["area1",
"area2"
],
"districts": ["mitino",
"central park"
],
"streets": ["arbat",
"schepkina"
],
"house_numbers": ["1",
"1/2str3"
],
"geo_position": {"origin_longitude": 36.616,
"origin_latitude": 55.752,
"longitude_delta": 0.01,
"latitude_delta": 0.01
},
"track_ids": ["track_id_number_1",
"track_id_number_2"
]
}
}
]
},
{"reference": {"id": "a68f5995-766d-4a27-889a-35e373d0f0b2",
"type": "event_external_id",
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
},
"matches": [{"result": [{"similarity": 1,
"event": {"create_time": "2018-08-11T09:11:41.674Z",
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"handler_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"external_id": "14159261415926",
"source": "Main_hall_camera",
"stream_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"top_match": {"face_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"similarity": 0.6,
"label": "good guys",
"external_id": "external_id_1"
},
"match_result": [{"candidates": [{"event": {"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": null,
"user_data": "user data",
"handler_id": null,
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"source": "cam_1"
},
"similarity": 0.5
}
],
"label": "good guy"
}
],
"face_detections": [{"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"body_detections": [{"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"face_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"attach_result": ["b668c4a5-2191-476e-a261-3b4f9ce2e25e"
],
"gender": 1,
"age": 29,
"emotion": 1,
"mask": 1,
"ethnic_group": 4,
"tags": ["tag1",
"tag2"
],
"user_data": "info",
"location": {"city": "Moscow",
"area": "string",
"district": "string",
"street": "Lenina",
"house_number": "3",
"geo_position": {"longitude": -63.9,
"latitude": 40.7
}
},
"track_id": "useful_track_id_number_1"
}
}
],
"filters": {"origin": "events",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397"
}
}
]
}
]

matcher options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

raw matching

Matcher raw API allows to do similarity calculations for input descriptors.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Content-Type	string Enum: "application/json" "application/msgpack" Format of a request body data.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Accept	string Default: application/json Enum: "application/json" "application/msgpack" Determines response mime-type which client to expect.

Request Body schema:
application/json

required	Array of xpk_file_entity (object) or sdk_descriptor_entity (object) or raw_descriptor_entity (object) non-empty Reference list for matching.
required	Array of xpk_file_entity (object) or sdk_descriptor_entity (object) or raw_descriptor_entity (object) non-empty Candidates for matching.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"references": [{"id": "string",
"type": "xpk_file",
"data": "string"
}
],
"candidates": [{"id": "string",
"type": "xpk_file",
"data": "string"
}
]
}

Response samples

Content type

application/json

{"matches": [{"reference_id": "46aeab25-df7d-46bd-afe2-cf60706a0d96",
"matches": [{"candidate_id": "f096439d-f306-49dc-bee9-266cb37e95eb",
"similarity": 0.635
}
]
},
{"reference_id": "raw-0",
"matches": [{"candidate_id": "candidate",
"similarity": 1
},
{"candidate_id": "sdk",
"similarity": 0.867
},
{"candidate_id": "xpk",
"similarity": 0.678
}
]
}
]
}

matcher raw options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

handlers

create handler

Create a handler.

The handler determines the list of rules (policies) for processing of input images.

Handlers can be static or dynamic.

When the handler is static, you specify its policies and then you specify the created handler ID during the event creation.

When the handler is dynamic, you create it without predefined policies and then you specify them during event creation. You can create the dynamic handler by setting "handler_type" field to 1.

Some parameters from the storage_policy are enabled by default (for example, face_sample_policy > store_sample). Don't forget to disable saving the necessary objects to avoid overflowing the storage.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

description	string <= 128 characters Description of the handler. Use it to distinguish the handler from other created handlers and filter handlers using "get handlers" and "get handler count" requests.
	object (Policies) The set of rules, which determine input images processing. The absence of policies indicates that the handler is dynamic.
handler_type	integer (handler_type) Default: 0 Enum: 0 1 2 Whether to get only non-dynamic (0), dynamic (1) or lambda (2) handlers. If type is non-dynamic: Handler will use policies what assigned to it. If type is dynamic: Handler will use given policies for each event generation request. If type is lambda: All requests will be sent to lambda handler using `lambda_id`. The format of the request and response body may not match what is specified for canonical handlers. Logic of the request behavior completely depends on the lambda, written by the user. For a description, see documentation of the lambda.
is_dynamic	boolean (is_dynamic) Deprecated Default: false Dynamic handler flag. If the value is set to "true", the handler is created without predefined policies. Use this flag to specify policies for each event created using resource "/handlers/{handler_id}/event". Use the request body schema "multipart/form-data" to specify policies.
lambda_id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Lambda ID.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

all policies specified

{"description": "Full handler example",
"policies": {"detect_policy": {"estimate_people_count": {"estimate": 1
},
"detect_face": 1,
"detect_body": 1,
"multiface_policy": 1,
"estimate_head_pose": 1,
"estimate_emotions": 1,
"estimate_mask": 1,
"estimate_quality": 1,
"estimate_gaze": 1,
"estimate_glasses": 1,
"estimate_eyes_attributes": 1,
"estimate_mouth_attributes": 1,
"detect_landmarks68": 1,
"extract_exif": 1,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [1
],
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 1
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
}
}
},
"body_attributes": {"estimate_basic_attributes": 1,
"estimate_upper_body": 1,
"estimate_lower_body": 1,
"estimate_accessories": 1
}
},
"extract_policy": {"extract_basic_attributes": 1,
"extract_face_descriptor": 1,
"fd_score_threshold": 0.6,
"extract_body_descriptor": 1
},
"match_policy": [{"label": "good guys",
"candidates": {"origin": "faces",
"face_ids": ["4db81a9a-515c-4cde-ac73-1810f5f737f2",
"957a48ba-f457-4814-829a-0fa55bc246fc"
],
"account_id": "6d071cca-fda5-4a03-84d5-5bea65904480",
"external_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12550"
],
"user_data": "operator",
"create_time__gte": "now-2y",
"create_time__lt": "2022-08-11T09:11:41.674Z",
"face_id__gte": "2046d39b-410d-481e-b9de-ede6a0c7367f",
"face_id__lt": "957a48ba-f457-4814-829a-0fa55bc246fc",
"list_id": "275d96c0-e655-4a69-a374-ad5e94b89bf9"
},
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
]
},
"limit": 3,
"targets": ["face_id"
],
"threshold": 0.5
}
],
"storage_policy": {"face_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"body_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"image_origin_policy": {"store_image": 1,
"use_external_references": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"attribute_policy": {"store_attribute": 1,
"ttl": 300,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"face_policy": {"store_face": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"set_sample_as_avatar": 0,
"link_to_lists_policy": [{"list_id": "79bee337-484f-4124-b7e2-e4b76fb26308",
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
}
]
},
"event_policy": {"store_event": 1,
"wait_saving": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"notification_policy": {"send_notification": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"callbacks": [{"type": "http",
"authorization": {"type": "basic",
"login": "username",
"password": "password"
},
"url": "http://127.0.0.1/",
"params": {"timeout": 5,
"content_type": "application/json",
"headers": { }
},
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"enable": 1
}
]
},
"conditional_tags_policy": [{"tag": "new_tag",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.3
}
]
}
}
]
},
"handler_type": 0
}

Response samples

Content type

application/json

{"handler_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/handlers/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/handlers/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

get handlers

Get handlers by filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.
handler_type	integer Enum: 0 1 2 Whether to get only handler with specific type (0 - static, 1 - dynamic, 2 - lambda). If not specified handlers of any type will be received. If `handler_type` specified, the deprecated `is_dynamic` parameter will be ignored.
is_dynamic	integer Deprecated Enum: 0 1 Whether to get only dynamic (1) or non-dynamic (0) handlers. If not specified handlers of both type will received.
description	string Records with descriptions similar to this parameter will be processed.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

params = {
    "description": "handler",
    "handler_type": 1,
    "page": 1,
}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/handlers"

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

[{"handler_id": "de0846a8-09b2-4c6f-8175-99cfae98cf6b",
"account_id": "3c3a83c2-c21e-4855-91b5-34e6b63fb12d",
"description": "first handler",
"policies": {"detect_policy": {"estimate_people_count": {"estimate": 1
},
"detect_face": 1,
"detect_body": 1,
"multiface_policy": 1,
"estimate_head_pose": 1,
"estimate_emotions": 1,
"estimate_mask": 1,
"estimate_quality": 1,
"estimate_gaze": 1,
"estimate_glasses": 1,
"estimate_eyes_attributes": 1,
"estimate_mouth_attributes": 1,
"detect_landmarks68": 1,
"extract_exif": 1,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [1
],
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"shoulders_position": {"estimate": 1,
"threshold": ["parallel"
]
}
}
},
"body_attributes": {"estimate_basic_attributes": 0,
"estimate_upper_body": 0,
"estimate_lower_body": 0,
"estimate_accessories": 0
}
},
"extract_policy": {"extract_basic_attributes": 1,
"extract_face_descriptor": 1,
"fd_score_threshold": 0.6,
"extract_body_descriptor": 1
},
"match_policy": [{"label": "good guys",
"candidates": {"origin": "faces",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2022-08-11T09:11:41.674Z"
},
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22
},
"limit": 3,
"targets": ["face_id"
],
"threshold": 0.5
}
],
"storage_policy": {"face_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"body_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"image_origin_policy": {"store_image": 1,
"use_external_references": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"attribute_policy": {"store_attribute": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"ttl": 300
},
"face_policy": {"store_face": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"set_sample_as_avatar": 0,
"link_to_lists_policy": [{"list_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
}
]
},
"event_policy": {"store_event": 1,
"wait_saving": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"notification_policy": {"send_notification": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"callbacks": [{"type": "http",
"authorization": {"type": "basic",
"login": "username",
"password": "password"
},
"url": "http://127.0.0.1/",
"params": {"timeout": 5,
"content_type": "application/json",
"headers": { }
},
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"enable": 1
}
]
},
"conditional_tags_policy": [{"tag": "new_tag",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.3
}
]
}
}
]
},
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z",
"handler_type": 0
},
{"handler_id": "ff0be071-1fd6-4641-a780-b8a87a871ef8",
"account_id": "3c3a83c2-c21e-4855-91b5-34e6b63fb12d",
"create_time": "2020-05-19T13:09:47.414773+03:00",
"last_update_time": "2020-05-19T13:09:47.414773+03:00",
"description": "76919ac6-95d2-4349-a7e9-5637117cdd29",
"policies": {"detect_policy": {"estimate_people_count": {"estimate": 1
},
"multiface_policy": 1,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_glasses": 1,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"detect_face": 1,
"detect_body": 0,
"pitch_threshold": null,
"roll_threshold": null,
"yaw_threshold": null,
"mask_states": null,
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"shoulders_position": {"estimate": 1,
"threshold": ["parallel"
]
}
}
},
"body_attributes": {"estimate_basic_attributes": 1,
"estimate_upper_body": 1,
"estimate_lower_body": 1,
"estimate_accessories": 1
}
},
"extract_policy": {"extract_basic_attributes": 0,
"fd_score_threshold": 0,
"extract_face_descriptor": 1,
"extract_body_descriptor": 0
},
"match_policy": [ ],
"conditional_tags_policy": [ ],
"storage_policy": {"face_sample_policy": {"filters": { },
"store_sample": 1
},
"body_sample_policy": {"filters": { },
"store_sample": 1
},
"image_origin_policy": {"filters": { },
"store_image": 0,
"use_external_references": 0
},
"attribute_policy": {"filters": { },
"store_attribute": 0,
"ttl": 300
},
"face_policy": {"filters": { },
"store_face": 0,
"set_sample_as_avatar": 1,
"link_to_lists_policy": [ ]
},
"event_policy": {"filters": { },
"store_event": 1,
"wait_saving": 1
},
"notification_policy": {"filters": { },
"send_notification": 1
},
"callbacks": [ ]
}
},
"handler_type": 0
}
]

handlers options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get handler count

Count handlers.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

description	string Find all the handlers with description similar to this parameter.
account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
handler_type	integer Enum: 0 1 2 Whether to get only handler with specific type (0 - static, 1 - dynamic, 2 - lambda). If not specified handlers of any type will be received. If `handler_type` specified, the deprecated `is_dynamic` parameter will be ignored.
is_dynamic	integer Deprecated Enum: 0 1 Whether to get only dynamic (1) or non-dynamic (0) handlers. If not specified handlers of both type will received.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

params = {
    "description": "handler",
    "handler_type": 0,
}

url = f"{baseUri}/handlers/count"

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"handlers_count": 5
}

handler count options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

validate handler policies

Validate handler policies before using them to create or update a handler.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

required

object (Policies)

The set of rules, which determine input images processing. The absence of policies indicates that the handler is dynamic.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"policies": {"detect_policy": {"estimate_people_count": {"estimate": 0
},
"detect_face": 1,
"detect_body": 0,
"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_glasses": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [ ],
"estimate_liveness": {"estimate": 0,
"liveness_threshold": 0.5,
"quality_threshold": 0.5
},
"liveness_states": [ ],
"estimate_deepfake": {"estimate": 0,
"real_threshold": 0.5,
"mode": 1
},
"deepfake_states": [ ],
"face_quality": {"estimate": 0,
"filter": 0,
"checks": {"image_format": {"estimate": 0,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"specularity_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"blurriness_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"dark_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"light_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_roll": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_smiling": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_occluded": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_open": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"glasses": {"estimate": 0,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 0,
"threshold": ["open"
]
},
"right_eye": {"estimate": 0,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 0,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 0,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 0,
"threshold": {"min": 91.1,
"max": 92.2
}
},
"image_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 0,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 0
}
},
"indent_left": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_right": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_upper": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_lower": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"image_size": {"estimate": 0,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 0,
"threshold": ["neutral"
]
},
"headwear_type": {"estimate": 0,
"threshold": ["none"
]
},
"smile_properties": {"estimate": 0,
"threshold": ["none"
]
},
"face_color_type": {"estimate": 0,
"threshold": ["color"
]
},
"natural_light": {"estimate": 0,
"threshold": 0
},
"red_eyes": {"estimate": 0,
"threshold": 0
},
"radial_distortion": {"estimate": 0,
"threshold": 0
},
"illumination_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 0,
"threshold": {"min": 0.2,
"max": 1
}
},
"shoulders_position": {"estimate": 0,
"threshold": ["parallel"
]
}
}
},
"body_attributes": {"estimate_basic_attributes": 0,
"estimate_upper_body": 0,
"estimate_lower_body": 0,
"estimate_accessories": 0
}
},
"extract_policy": {"extract_basic_attributes": 0,
"extract_face_descriptor": 1,
"fd_score_threshold": 0.7,
"extract_body_descriptor": 0
},
"match_policy": [{"label": "",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
]
},
"descriptor": {"descriptor_type": "face"
},
"limit": 3,
"targets": ["face_id"
],
"threshold": 0.5,
"candidates": {"origin": "faces",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"account_id": "string",
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "string",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z"
}
}
],
"storage_policy": {"face_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"body_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"image_origin_policy": {"store_image": 0,
"use_external_references": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"attribute_policy": {"store_attribute": 0,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"ttl": 300
},
"face_policy": {"store_face": 0,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"set_sample_as_avatar": 1,
"link_to_lists_policy": [{"list_id": "string",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
}
]
},
"event_policy": {"store_event": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"wait_saving": 1
},
"notification_policy": {"send_notification": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"callbacks": [{"type": "http",
"authorization": {"type": "basic",
"login": "string",
"password": "string"
},
"url": "../dictionary",
"params": {"timeout": 60,
"content_type": "application/json",
"headers": { }
},
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"enable": 1
}
]
},
"conditional_tags_policy": [{"tag": "good",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
}
]
}
}

Response samples

Content type

application/json

Example

bad_content_type

{"error_code": 12017,
"desc": "Bad/incomplete input data",
"detail": "Bad content type",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12017"
}

handler policies validator options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get handler

Get handler by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

import requests

baseUri = "http://127.0.0.1:5000/6"

# create handler
headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}
url = f"{baseUri}/handlers"
payload = {"handler_type": 1}
dynamicHandlerId = requests.post(url, json=payload, headers=headers).json()["handler_id"]

# get handler
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="
}
url = f"{baseUri}/handlers/{dynamicHandlerId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"handler_id": "de0846a8-09b2-4c6f-8175-99cfae98cf6b",
"account_id": "3c3a83c2-c21e-4855-91b5-34e6b63fb12d",
"description": "first handler",
"policies": {"detect_policy": {"estimate_people_count": {"estimate": 0
},
"detect_face": 1,
"detect_body": 1,
"multiface_policy": 1,
"estimate_head_pose": 1,
"estimate_emotions": 1,
"estimate_mask": 1,
"estimate_quality": 1,
"estimate_gaze": 1,
"estimate_glasses": 1,
"estimate_eyes_attributes": 1,
"estimate_mouth_attributes": 1,
"detect_landmarks68": 1,
"extract_exif": 1,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [1
],
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"shoulders_position": {"estimate": 1,
"threshold": ["parallel"
]
}
}
},
"body_attributes": {"estimate_basic_attributes": 0,
"estimate_upper_body": 0,
"estimate_lower_body": 0,
"estimate_accessories": 0
}
},
"extract_policy": {"extract_basic_attributes": 1,
"extract_face_descriptor": 1,
"fd_score_threshold": 0.6,
"extract_body_descriptor": 1
},
"match_policy": [{"label": "good guys",
"candidates": {"origin": "faces",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2022-08-11T09:11:41.674Z"
},
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22
},
"limit": 3,
"targets": ["face_id"
],
"threshold": 0.5
}
],
"storage_policy": {"face_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"body_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"image_origin_policy": {"store_image": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"attribute_policy": {"store_attribute": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"ttl": 300
},
"face_policy": {"store_face": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"set_sample_as_avatar": 0,
"link_to_lists_policy": [{"list_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
}
]
},
"event_policy": {"store_event": 1,
"wait_saving": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"notification_policy": {"send_notification": 1,
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
}
},
"callbacks": [{"type": "http",
"authorization": {"type": "basic",
"login": "username",
"password": "password"
},
"url": "http://127.0.0.1/",
"params": {"timeout": 5,
"content_type": "application/json",
"headers": { }
},
"filters": {"gender": 1,
"ethnicities": [1
],
"age__lt": 0,
"age__gte": 0,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.9
}
]
},
"enable": 1
}
]
},
"conditional_tags_policy": [{"tag": "new_tag",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 50,
"age__gte": 22,
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.3
}
]
}
}
]
},
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z",
"handler_type": 0
}

replace handler

Update handler. You cannot update a part of the handler, so you should specify all the fields for your handler.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

description	string <= 128 characters Description of the handler. Use it to distinguish the handler from other created handlers and filter handlers using "get handlers" and "get handler count" requests.
	object (Policies) The set of rules, which determine input images processing. The absence of policies indicates that the handler is dynamic.
handler_type	integer (handler_type) Default: 0 Enum: 0 1 2 Whether to get only non-dynamic (0), dynamic (1) or lambda (2) handlers. If type is non-dynamic: Handler will use policies what assigned to it. If type is dynamic: Handler will use given policies for each event generation request. If type is lambda: All requests will be sent to lambda handler using `lambda_id`. The format of the request and response body may not match what is specified for canonical handlers. Logic of the request behavior completely depends on the lambda, written by the user. For a description, see documentation of the lambda.
is_dynamic	boolean (is_dynamic) Deprecated Default: false Dynamic handler flag. If the value is set to "true", the handler is created without predefined policies. Use this flag to specify policies for each event created using resource "/handlers/{handler_id}/event". Use the request body schema "multipart/form-data" to specify policies.
lambda_id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Lambda ID.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "Handler example",
"policies": {"detect_policy": {"estimate_people_count": {"estimate": 0
},
"detect_face": 1,
"detect_body": 0,
"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_glasses": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [ ],
"estimate_liveness": {"estimate": 0,
"liveness_threshold": 0.5,
"quality_threshold": 0.5
},
"liveness_states": [ ],
"estimate_deepfake": {"estimate": 0,
"real_threshold": 0.5,
"mode": 1
},
"deepfake_states": [ ],
"face_quality": {"estimate": 0,
"filter": 0,
"checks": {"image_format": {"estimate": 0,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"specularity_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"blurriness_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"dark_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"light_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_roll": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_smiling": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_occluded": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_open": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"glasses": {"estimate": 0,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 0,
"threshold": ["open"
]
},
"right_eye": {"estimate": 0,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 0,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 0,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 0,
"threshold": {"min": 91.1,
"max": 92.2
}
},
"image_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 0,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 0
}
},
"indent_left": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_right": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_upper": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_lower": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"image_size": {"estimate": 0,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 0,
"threshold": ["neutral"
]
},
"headwear_type": {"estimate": 0,
"threshold": ["none"
]
},
"smile_properties": {"estimate": 0,
"threshold": ["none"
]
},
"face_color_type": {"estimate": 0,
"threshold": ["color"
]
},
"natural_light": {"estimate": 0,
"threshold": 0
},
"red_eyes": {"estimate": 0,
"threshold": 0
},
"radial_distortion": {"estimate": 0,
"threshold": 0
},
"illumination_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 0,
"threshold": {"min": 0.2,
"max": 1
}
},
"shoulders_position": {"estimate": 0,
"threshold": ["parallel"
]
}
}
},
"body_attributes": {"estimate_basic_attributes": 0,
"estimate_upper_body": 0,
"estimate_lower_body": 0,
"estimate_accessories": 0
}
},
"extract_policy": {"extract_basic_attributes": 0,
"extract_face_descriptor": 1,
"fd_score_threshold": 0.7,
"extract_body_descriptor": 0
},
"match_policy": [{"label": "",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
]
},
"descriptor": {"descriptor_type": "face"
},
"limit": 3,
"targets": ["face_id"
],
"threshold": 0.5,
"candidates": {"origin": "faces",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"account_id": "string",
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "string",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z"
}
}
],
"storage_policy": {"face_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"body_sample_policy": {"store_sample": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"image_origin_policy": {"store_image": 0,
"use_external_references": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"attribute_policy": {"store_attribute": 0,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"ttl": 300
},
"face_policy": {"store_face": 0,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"set_sample_as_avatar": 1,
"link_to_lists_policy": [{"list_id": "string",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
}
]
},
"event_policy": {"store_event": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"wait_saving": 1
},
"notification_policy": {"send_notification": 1,
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
},
"callbacks": [{"type": "http",
"authorization": {"type": "basic",
"login": "string",
"password": "string"
},
"url": "../dictionary",
"params": {"timeout": 60,
"content_type": "application/json",
"headers": { }
},
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
},
"enable": 1
}
]
},
"conditional_tags_policy": [{"tag": "good",
"filters": {"gender": 1,
"ethnicities": [4,
3
],
"age__lt": 30,
"age__gte": 22,
"liveness": [1
],
"deepfake": [1
],
"match": [{"label": "good guys",
"similarity__lte": 0.9,
"similarity__gte": 0.78
}
]
}
}
]
},
"handler_type": 0,
"is_dynamic": false,
"lambda_id": "string"
}

Response samples

Content type

application/json

Example

bad_content_type

{"error_code": 12017,
"desc": "Bad/incomplete input data",
"detail": "Bad content type",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12017"
}

check if handler exists

Check if handler with handler_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/handlers"

payload = {"handler_type": 1}
dynamicHandlerId = requests.post(url, json=payload, headers=headers).json()["handler_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/handlers/{dynamicHandlerId}"
response = requests.head(url, headers=headers)

print(response.status_code)

remove handler

Remove handler by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/handlers"

payload = {"handler_type": 1}
dynamicHandlerId = requests.post(url, json=payload, headers=headers).json()["handler_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/handlers/{dynamicHandlerId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_format

{"error_code": 11065,
"desc": "Authorization failed",
"detail": "Bad format basic authorization header",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-36002"
}

handler options

Get options for the resource.

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

events

generate events

Process images and/or raw descriptors using the specified handler and generate events.

Specify the multipart/form-data schema if you need to specify the dynamic handler policies.

If the Events service support is disabled on the server, events will not be saved to the database.

Notes for incoming data:

set the image detection time, if necessary, otherwise it will be equal to the request time.
face or body bounding boxes passed with face or body warped image will presented as sample detection rect in generated event.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

query Parameters

city	string (location_str) <= 36 characters Example: city=New York City where an event occurred.
area	string (location_str) <= 36 characters Example: area=Manhattan Area where an event occurred.
district	string (location_str) <= 36 characters Example: district=Midtown District where an event occurred.
street	string (location_str) <= 36 characters Example: street=West 48th street Street where an event occurred.
house_number	string (location_str) <= 36 characters Example: house_number=220 House number where an event occurred.
longitude	number (longitude) [ -180 .. 180 ] Example: longitude=36.616 Longitude in degrees, a part of composite geo position. Geo position is considered as properly specified if both longitude and latitude are set.
latitude	number (latitude) [ -90 .. 90 ] Example: latitude=55.752 Latitude in degrees, a part of composite geo position. Geo position is considered as properly specified if both longitude and latitude are set.
external_id	string (event_external_id) <= 36 characters Default: "" Example: external_id=14159261415926 External ID for created events and faces (if `store_face` is enabled in handler). When Unicode symbols (for example, the "+" symbol) are used in "external_id", the string should be encoded. Otherwise, the Unicode symbols will be lost. The "luna3" client library provides the encoding example
user_data	string (face_user_data) <= 128 characters Default: "" Example: user_data=face of person User data for created events and faces (if `store_face` is enabled in handler).
image_type	integer Default: 0 Enum: 0 1 2 Type of input image. 0 - raw image, 1 - face warped image, 2 - body warped image.
aggregate_attributes	integer (aggregate_attributes) Whether to aggregate the following parameters: face descriptor (not displayed in the response body) body descriptor (not displayed in the response body) face basic attributes (age, gender) body basic attributes (apparent age, apparent gender) mask states emotions liveness deepfake upper body accessories Aggregation will be performed only if the appropriate parameters for estimating the listed above parameters are enabled in the handler. If set, all estimated parameters from each image will be aggregated and stored in the event as single objects for all images. In the response body, the aggregated face basic attributes of all images will be displayed in the `face_attributes` > `basic_attributes` field, and the other aggregated parameters will be displayed in the `aggregate_estimations` field. Otherwise, all estimated parameters from each image will be stored in the event as separate objects. In the response body, the face basic attributes will be displayed in the `face_attributes` > `basic_attributes` field of the corresponding image, and the other parameters will be displayed in the `detections` > `samples` > `face`/`body` > `detection` > `attributes` field of the corresponding image.
source	string (source) <= 128 characters Example: source=3rd Avenue Additional information provided by user along with event.
stream_id	string <uuid> (stream_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: stream_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Stream ID.
tags	Array of strings (tag) >= 0 items [ items <= 36 characters ] Example: tags=tag_1,tag_2 Comma-separated list of tags. Each event from result will contain all of given tags. Each tag can be at most 36 characters.
track_id	string (track_id) ^[a-zA-Z0-9_\-]{1,36}$ Example: track_id=useful_track_id_number_1 Event track ID.
use_exif_info	integer Default: 1 Enum: 0 1 Example: use_exif_info=1 Whether to try to auto orient image based on EXIF data. The processed image should have EXIF data, otherwise auto orientation will not be performed. Has no effect with tiff images (they're always auto oriented). Ignored with warped images (see `warped_image` or `image_type` parameter).

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Luna-Event-Time	string <date-time> (time) Examples: 2018-12-16T15:29:59.300275-08:00 - time with timezone with an offset of -08:00 from UTC (Pacific Standard Time). 2018-12-16T15:29:59.300275Z - utc time. The "Z" suffix denotes a UTC offset of 00:00 (Zulu). User defined event time. All events will be saved with this time as "create_time". Format of time is rfc3339. Any other format is ignored.
Luna-Event-End-Time	string <date-time> (time) Examples: 2018-12-16T15:29:59.300275-08:00 - time with timezone with an offset of -08:00 from UTC (Pacific Standard Time). 2018-12-16T15:29:59.300275Z - utc time. The "Z" suffix denotes a UTC offset of 00:00 (Zulu). User defined event end time. All events will be saved with this time as "end_time". Format of time is rfc3339. All other format is ignored.
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "multipart/form-data" "application/json" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64" "application/x-sdk-descriptor" "application/x-vl-xpk" "application/x-sdk-descriptor-base64" "applicaition/x-vl-xpk-base64"

Request Body schema:
image/jpeg

string <binary>

Responses

Request samples

Payload
python
python
bash
bash

Content type

image/jpeg

No sample

Response samples

Content type

application/json

Example

all policies specified

{"images": [{"error": {"error_code": 0,
"desc": "Success",
"detail": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"status": 1,
"filename": "person.jpg",
"exif": {"flash": "16",
"software": "Adobe Photoshop CC 2017 (Windows)",
"artist": "VisionLabs",
"make": "NIKON CORPORATION",
"model": "NIKON D810"
},
"image_estimations": {"people": {"count": 1
}
}
}
],
"events": [{"face_attributes": {"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"basic_attributes": {"age": 29,
"gender": 1,
"ethnicities": {"estimations": {"african_american": 1.92238889737406e-12,
"asian": 0.954671621322632,
"caucasian": 0.045328326523304,
"indian": 7.65100649502415e-10
},
"predominant_ethnicity": "asian"
}
},
"score": 0.7525901794,
"url": "/6/attributes/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
],
"filter": {"is_filtered": true,
"filter_reasons": [{"filter_name": "score_threshold",
"object_value": 0,
"threshold_value": 0
}
]
}
},
"body_attributes": {"score": 0.3546702648,
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
]
},
"source": "3rd Avenue",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"tags": ["tag1",
"tag2"
],
"external_id": "b668c4a5-2191-some-important-words",
"user_data": "string",
"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"user_data": "fox1991",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"avatar": "/6/samples/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"url": "/6/faces/24d405ce-bc56-4bf7-98e1-bdc962b4cf34"
},
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"url": "/6/events/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"matches": [{"label": "good guys",
"candidates": [{"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"avatar": "/6/samples/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256"
},
"similarity": 0.5
}
]
},
{"label": "bad guys",
"candidates": [{"event": {"event_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"source": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"stream_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7"
},
"similarity": 0.3
}
]
}
],
"location": {"city": "string",
"area": "string",
"district": "string",
"street": "string",
"house_number": "string",
"geo_position": {"longitude": 36.616,
"latitude": 55.752
}
},
"detections": [{"filename": "penelope.jpeg",
"samples": {"body": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"attributes": {"basic_attributes": {"apparent_age": 0,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
},
"url": "/6/samples/bodies/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c"
},
"face": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"attributes": {"mouth_attributes": {"occluded": 0,
"opened": 0,
"score": 1,
"smile": 0
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
},
"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"predominant_mask": "medical_mask",
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
},
"eyes_attributes": {"right_eye": {"state": "open",
"iris_landmarks": [[152,
152
],
[153,
153
],
[153,
153
],
[154,
154
],
[154,
154
],
[155,
155
],
[157,
157
],
[158,
158
],
[159,
159
],
[161,
161
],
[162,
162
],
[163,
163
],
[164,
164
],
[165,
165
],
[166,
166
],
[166,
166
],
[167,
167
],
[167,
167
],
[166,
166
],
[166,
166
],
[165,
165
],
[164,
164
],
[162,
162
],
[161,
161
],
[160,
160
],
[158,
158
],
[157,
157
],
[156,
156
],
[155,
155
],
[154,
154
],
[154,
154
],
[153,
153
]
]
},
"left_eye": {"state": "open",
"iris_landmarks": [[92,
92
],
[92,
92
],
[92,
92
],
[93,
93
],
[94,
94
],
[95,
95
],
[96,
96
],
[97,
97
],
[98,
98
],
[100,
100
],
[101,
101
],
[102,
102
],
[103,
103
],
[104,
104
],
[104,
104
],
[105,
105
],
[105,
105
],
[105,
105
],
[104,
104
],
[104,
104
],
[103,
103
],
[103,
103
],
[102,
102
],
[100,
100
],
[99,
99
],
[98,
98
],
[97,
97
],
[95,
95
],
[94,
94
],
[93,
93
],
[93,
93
],
[92,
92
]
]
}
}
},
"quality": {"light": 0.87,
"dark": 0.13,
"illumination": 0.1,
"specularity": 0.1,
"blurriness": 0.2
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"landmarks68": [[8,
8
],
[14,
14
],
[28,
28
],
[48,
48
],
[72,
72
],
[102,
102
],
[134,
134
],
[168,
168
],
[213,
213
],
[262,
262
],
[306,
306
],
[345,
345
],
[376,
376
],
[392,
392
],
[397,
397
],
[399,
399
],
[394,
394
],
[2,
2
],
[22,
22
],
[50,
50
],
[79,
79
],
[106,
106
],
[165,
165
],
[199,
199
],
[236,
236
],
[278,
278
],
[317,
317
],
[137,
137
],
[136,
136
],
[136,
136
],
[136,
136
],
[119,
119
],
[135,
135
],
[154,
154
],
[174,
174
],
[193,
193
],
[40,
40
],
[57,
57
],
[83,
83
],
[108,
108
],
[84,
84
],
[58,
58
],
[203,
203
],
[222,
222
],
[249,
249
],
[277,
277
],
[258,
258
],
[229,
229
],
[119,
119
],
[130,
130
],
[149,
149
],
[167,
167
],
[185,
185
],
[222,
222
],
[259,
259
],
[232,
232
],
[200,
200
],
[177,
177
],
[155,
155
],
[134,
134
],
[127,
127
],
[152,
152
],
[170,
170
],
[190,
190
],
[250,
250
],
[193,
193
],
[172,
172
],
[152,
152
]
],
"landmarks5": [[72,
72
],
[240,
240
],
[154,
154
],
[119,
119
],
[259,
259
]
],
"face_quality": {"status": 0,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "image_width",
"object_value": 1000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "image_height",
"object_value": 2000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "aspect_ratio",
"object_value": 0.5,
"threshold_value": {"min": 0.1,
"max": 1
},
"result": 1
},
{"name": "face_width",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "face_height",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "indent_left",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_right",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_upper",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_lower",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "image_size",
"object_value": 100500,
"threshold_value": {"min": 10,
"max": 100600
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "illumination_uniformity",
"object_value": 0.7305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "dynamic_range",
"object_value": 0.6605162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"threshold_value": {"min": 0.2,
"max": 1
},
"result": 1
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "shoulders_position",
"object_value": "parallel",
"threshold_value": ["parallel"
],
"result": 1
}
]
}
},
"url": "/6/samples/faces/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c"
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"track_id": "useful_track_id_number_1",
"meta": {"foo": "bar"
},
"aggregate_estimations": {"face": {"attributes": {"liveness": {"prediction": "real",
"estimations": {"quality": 0.9,
"score": 0.8
}
},
"deepfake": {"prediction": "real",
"score": 0.8
}
}
},
"body": {"attributes": {"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
}
}
}
],
"filtered_detections": {"face_detections": [ ]
}
}

generate events options

Get options for the resource.

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

generate stream events (beta)

WARNING Experimental resource. Backwards compatibility is not guaranteed.

Process images using the specified handler and generate stream events.

If the Events service support is disabled on the server, events will not be saved to the database.

Notes for incoming data:

set the image detection time, if necessary, otherwise it will be equal to the request time.
face or body bounding boxes passed with face or body warped image will presented as sample detection rect in generated event.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/msgpack" Format of a request body data.

Request Body schema: application/msgpack

aggregate_attributes required	integer (aggregate_attributes) Whether to aggregate attributes. If the value is set to "0", a descriptor and basic attributes are extracted for each sample. If the value is set to "1", you can create an aggregated descriptor, receive aggregated basic attributes, or both. The behavior depends on the `extract_basic_attributes` and `extract_descriptor` parameters: If `extract_descriptor` is enabled, all the samples in the request will be used to create a single descriptor. An aggregated descriptor gives you more accurate results upon descriptors comparison. If `extract_basic_attributes` is enabled, all the samples in the request will be used to extract basic attributes. Age, gender and ethnicity values received from several samples are more precise. Make sure that all the samples in the request belong to the same person. If there are several faces in the input image, an error occurs. 0
required	Array of any (event_sources_non_aggregated) non-empty
use_exif_info	integer (use_exif_info) Default: 1 Enum: 0 1 Whether to try to auto orient image based on exif data Has no effect with tiff images (they're always auto oriented). Ignored with warped images (see `warped_image` or `image_type` parameter).

Responses

Response samples

Content type

application/json

Example

all policies specified

{"images": [{"error": {"error_code": 0,
"desc": "Success",
"detail": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"status": 1,
"filename": "person.jpg",
"exif": {"flash": "16",
"software": "Adobe Photoshop CC 2017 (Windows)",
"artist": "VisionLabs",
"make": "NIKON CORPORATION",
"model": "NIKON D810"
},
"image_estimations": {"people": {"count": 1
}
}
}
],
"events": [{"face_attributes": {"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"basic_attributes": {"age": 29,
"gender": 1,
"ethnicities": {"estimations": {"african_american": 1.92238889737406e-12,
"asian": 0.954671621322632,
"caucasian": 0.045328326523304,
"indian": 7.65100649502415e-10
},
"predominant_ethnicity": "asian"
}
},
"score": 0.7525901794,
"url": "/6/attributes/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
],
"filter": {"is_filtered": true,
"filter_reasons": [{"filter_name": "score_threshold",
"object_value": 0,
"threshold_value": 0
}
]
}
},
"body_attributes": {"score": 0.3546702648,
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
]
},
"source": "3rd Avenue",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"tags": ["tag1",
"tag2"
],
"external_id": "b668c4a5-2191-some-important-words",
"user_data": "string",
"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"user_data": "fox1991",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"avatar": "/6/samples/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"url": "/6/faces/24d405ce-bc56-4bf7-98e1-bdc962b4cf34"
},
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"url": "/6/events/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"matches": [{"label": "good guys",
"candidates": [{"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"avatar": "/6/samples/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256"
},
"similarity": 0.5
}
]
},
{"label": "bad guys",
"candidates": [{"event": {"event_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"source": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"stream_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7"
},
"similarity": 0.3
}
]
}
],
"location": {"city": "string",
"area": "string",
"district": "string",
"street": "string",
"house_number": "string",
"geo_position": {"longitude": 36.616,
"latitude": 55.752
}
},
"detections": [{"filename": "penelope.jpeg",
"samples": {"body": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"attributes": {"basic_attributes": {"apparent_age": 0,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
},
"url": "/6/samples/bodies/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c"
},
"face": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"attributes": {"mouth_attributes": {"occluded": 0,
"opened": 0,
"score": 1,
"smile": 0
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
},
"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"predominant_mask": "medical_mask",
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
},
"eyes_attributes": {"right_eye": {"state": "open",
"iris_landmarks": [[152,
152
],
[153,
153
],
[153,
153
],
[154,
154
],
[154,
154
],
[155,
155
],
[157,
157
],
[158,
158
],
[159,
159
],
[161,
161
],
[162,
162
],
[163,
163
],
[164,
164
],
[165,
165
],
[166,
166
],
[166,
166
],
[167,
167
],
[167,
167
],
[166,
166
],
[166,
166
],
[165,
165
],
[164,
164
],
[162,
162
],
[161,
161
],
[160,
160
],
[158,
158
],
[157,
157
],
[156,
156
],
[155,
155
],
[154,
154
],
[154,
154
],
[153,
153
]
]
},
"left_eye": {"state": "open",
"iris_landmarks": [[92,
92
],
[92,
92
],
[92,
92
],
[93,
93
],
[94,
94
],
[95,
95
],
[96,
96
],
[97,
97
],
[98,
98
],
[100,
100
],
[101,
101
],
[102,
102
],
[103,
103
],
[104,
104
],
[104,
104
],
[105,
105
],
[105,
105
],
[105,
105
],
[104,
104
],
[104,
104
],
[103,
103
],
[103,
103
],
[102,
102
],
[100,
100
],
[99,
99
],
[98,
98
],
[97,
97
],
[95,
95
],
[94,
94
],
[93,
93
],
[93,
93
],
[92,
92
]
]
}
}
},
"quality": {"light": 0.87,
"dark": 0.13,
"illumination": 0.1,
"specularity": 0.1,
"blurriness": 0.2
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"landmarks68": [[8,
8
],
[14,
14
],
[28,
28
],
[48,
48
],
[72,
72
],
[102,
102
],
[134,
134
],
[168,
168
],
[213,
213
],
[262,
262
],
[306,
306
],
[345,
345
],
[376,
376
],
[392,
392
],
[397,
397
],
[399,
399
],
[394,
394
],
[2,
2
],
[22,
22
],
[50,
50
],
[79,
79
],
[106,
106
],
[165,
165
],
[199,
199
],
[236,
236
],
[278,
278
],
[317,
317
],
[137,
137
],
[136,
136
],
[136,
136
],
[136,
136
],
[119,
119
],
[135,
135
],
[154,
154
],
[174,
174
],
[193,
193
],
[40,
40
],
[57,
57
],
[83,
83
],
[108,
108
],
[84,
84
],
[58,
58
],
[203,
203
],
[222,
222
],
[249,
249
],
[277,
277
],
[258,
258
],
[229,
229
],
[119,
119
],
[130,
130
],
[149,
149
],
[167,
167
],
[185,
185
],
[222,
222
],
[259,
259
],
[232,
232
],
[200,
200
],
[177,
177
],
[155,
155
],
[134,
134
],
[127,
127
],
[152,
152
],
[170,
170
],
[190,
190
],
[250,
250
],
[193,
193
],
[172,
172
],
[152,
152
]
],
"landmarks5": [[72,
72
],
[240,
240
],
[154,
154
],
[119,
119
],
[259,
259
]
],
"face_quality": {"status": 0,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "image_width",
"object_value": 1000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "image_height",
"object_value": 2000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "aspect_ratio",
"object_value": 0.5,
"threshold_value": {"min": 0.1,
"max": 1
},
"result": 1
},
{"name": "face_width",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "face_height",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "indent_left",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_right",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_upper",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_lower",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "image_size",
"object_value": 100500,
"threshold_value": {"min": 10,
"max": 100600
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "illumination_uniformity",
"object_value": 0.7305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "dynamic_range",
"object_value": 0.6605162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"threshold_value": {"min": 0.2,
"max": 1
},
"result": 1
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "shoulders_position",
"object_value": "parallel",
"threshold_value": ["parallel"
],
"result": 1
}
]
}
},
"url": "/6/samples/faces/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c"
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"track_id": "useful_track_id_number_1",
"meta": {"foo": "bar"
},
"aggregate_estimations": {"face": {"attributes": {"liveness": {"prediction": "real",
"estimations": {"quality": 0.9,
"score": 0.8
}
},
"deepfake": {"prediction": "real",
"score": 0.8
}
}
},
"body": {"attributes": {"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
}
}
}
],
"filtered_detections": {"face_detections": [ ]
}
}

generate stream events options

Get options for the resource.

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

save event

Save event which was generated by the user. The event structure is similar to an event from handler response. Input events will send to the Sender also and to plugins. Therefore, these events are the same events except that events were generated an external handler. Handler ID must belong to a dynamic handler.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Dynamic handler ID.

query Parameters

wait_saving

integer

Default: 1

Enum: 0 1

Whether to wait for raw event saving.

If "0" is specified, the 202 status code will be expected in response to a successful request. This status code is returned after event is validated and added to the buffer. The system does not wait until the event is saved to the database. The event will be stored in the database after the response is sent.

If "1" is specified, the 201 status code will be expected in response to a successful request. This status code is returned only after event is stored in the database.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

	Array of objects <= 100 items List of body & face related detections.
source	string (source) <= 128 characters Additional information that user provides with event.
stream_id	string <uuid> (stream_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Stream ID.
	object (input_event_location) Information about place where an event occurred.
external_id	string (event_external_id) <= 36 characters Default: "" User-defined external ID for the event.
user_data	string (event_user_data) <= 128 characters Default: "" User data associated with event.
track_id	string (track_id) ^[a-zA-Z0-9_\-]{1,36}$ Event track ID.
	object (input_event_face) Face associated with event.
	Array of objects or null <= 30 items Sorted list with match result for the event.
	object or null (input_event_face_attribute) User extracted event face attributes.
	object or null (input_event_body_attribute) User extracted event body attributes.
	object (input_event_aggregate_estimations) Aggregated attributes estimated from samples.
tags	Array of strings [ 0 .. 1000 ] items [ items <= 36 characters ] List of tags.
create_time	string <date-time> Time of the event creation.
end_time	string <date-time> The end time of the event.
	object (event_meta_common) User defined metadata (JSON object). Size shouldn't exceed 2MB. To be able to further search for meta using GET requests, JSON must have a valid format without spaces in field names. Use only latin letters, numbers, and single underscores in field names.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"detections": [{"filename": "",
"samples": {"body": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"attributes": {"basic_attributes": {"apparent_age": 33,
"apparent_gender": 1
},
"upper_body": {"headwear": {"state": 1,
"apparent_color": "undefined"
},
"sleeve": {"length": "long"
},
"upper_clothing": {"colors": ["black",
"white"
]
}
},
"lower_body": {"lower_garment": {"type": "undefined",
"colors": ["black",
"white"
]
},
"shoes": {"apparent_color": "undefined"
}
},
"accessories": {"backpack": {"state": 1
}
}
}
},
"url": "/6/samples/bodies/45838c8b-04a1-4230-bda0-b5f77609b695"
},
"face": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"detection": {"quality": {"light": 0.87,
"dark": 0.13,
"illumination": 0.1,
"specularity": 0.1,
"blurriness": 0.2
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"landmarks5": [ ],
"landmarks68": [ ],
"attributes": {"mouth_attributes": {"occluded": 0,
"score": 0.999999165534973,
"smile": 0
},
"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"predominant_mask": "medical_mask",
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
},
"glasses": {"glasses": "no_glasses"
},
"liveness": {"prediction": "real",
"estimations": {"score": 0.99,
"quality": 1
}
},
"deepfake": {"prediction": "real",
"score": 0.99
}
},
"face_quality": {"status": 0,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": [null
],
"result": 0
}
]
}
},
"url": "/6/samples/faces/45838c8b-04a1-4230-bda0-b5f77609b695"
}
},
"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e\n"
}
],
"source": "3rd Avenue",
"stream_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"location": {"city": "string",
"area": "string",
"district": "string",
"street": "string",
"house_number": "string",
"geo_position": {"longitude": 0,
"latitude": 0
}
},
"external_id": "14159261415926",
"user_data": "some event",
"track_id": "useful_track_id_number_1",
"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"url": "/6/faces/426542d6-5509-4e5b-8a01-e2abd5c0a8c6"
},
"matches": [{"label": "good guys",
"candidates": [{"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z"
},
"similarity": 0.5
}
]
},
{"label": "bad guys",
"candidates": [{"event": {"event_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"source": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"stream_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7"
},
"similarity": 0.3
}
]
}
],
"face_attributes": {"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"basic_attributes": {"age": 29,
"gender": 1,
"ethnicities": {"predominant_ethnicity": "african_american",
"estimations": {"asian": 1,
"indian": 1,
"caucasian": 1,
"african_american": 1
}
}
},
"score": 1,
"samples": [ ],
"descriptor": "string",
"url": "../dictionary"
},
"body_attributes": {"score": 1,
"samples": [ ],
"descriptor": "string"
},
"aggregate_estimations": {"face": {"attributes": null
},
"body": {"attributes": {"basic_attributes": {"apparent_age": 33,
"apparent_gender": 1
},
"upper_body": {"headwear": {"state": 1,
"apparent_color": "undefined"
},
"sleeve": {"length": "long"
},
"upper_clothing": {"colors": ["black",
"white"
]
}
},
"lower_body": {"lower_garment": {"type": "undefined",
"colors": ["black",
"white"
]
},
"shoes": {"apparent_color": "undefined"
}
},
"accessories": {"backpack": {"state": 1
}
}
}
}
},
"tags": ["tag1",
"tag2"
],
"create_time": "2018-08-11T09:11:41.674Z",
"end_time": "2018-08-11T09:11:41.674Z",
"meta": {"key": "value"
}
}

Response samples

Content type

application/json

{"event_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/events/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/events/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

save event options

Get options for the resource.

path Parameters

handler_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Dynamic handler ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get statistics on events

Get event statistics by target(s) with applied filters.

Event fields and/or functions (count, min, etc.) can be set as targets for aggregation of events.

Grouping by frequency or grouping by time intervals is available.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

Array of objects (targets) >= 0 items

Default: [{"column":"event_id","aggregator":"count"}]

You can specify one or several event fields and functions for them for data aggregation.

The table includes event fields and available functions for them:

Column	Aggregator
	count	max	min	avg	group_by
event_id	+	-	-	-	+
external_id	+	-	-	-	+
handler_id	+	-	-	-	+
stream_id	+	-	-	-	+
source	+	-	-	-	+
top_matching_candidates_label	+	-	-	-	+
top_similar_object_id	+	-	-	-	+
top_similar_external_id	+	-	-	-	+
top_similar_object_similarity	+	+	+	+	-
create_time	+	+	+	-	-
end_time	+	+	+	-	-
face_id	+	-	-	-	+
gender	+	+	+	+	+
age	+	+	+	+	+
emotion	+	+	+	+	+
mask	+	+	+	+	+
ethnic_group	+	+	+	+	+
liveness	+	+	+	+	+
deepfake	+	+	+	+	+
user_data	+	-	-	-	+
tags	+	+	+	-	-
city	+	-	-	-	+
area	+	-	-	-	+
district	+	-	-	-	+
street	+	-	-	-	+
house_number	+	-	-	-	+
geo_position	+	-	-	-	-
track_id	+	-	-	-	+
apparent_age	+	+	+	+	+
apparent_gender	+	+	+	+	+
sleeve_length	+	-	-	-	+
headwear_state	+	+	+	+	+
headwear_apparent_color	+	-	-	-	+
upper_clothing_colors	+	-	-	-	-
lower_garment_colors	+	-	-	-	-
lower_garment_type	+	-	-	-	+
shoes_apparent_color	+	-	-	-	+
backpack_state	+	+	+	+	+
meta.*	+	+	+	+	-

Note! There must be at least one function different from group_by in the targets, otherwise an error occurs.

Array of objects (filters) >= 0 items

Specifies filters for events.

Operators available for each filter:

Filter	Operator
	like, nlike	in, nin	eq, neq	gt, gte, lt, lte	covered	eq null
tags	+	-	-	-	-	-
source	-	+	+	-	-	+
stream_id	-	+	+	-	-	+
user_data	-	+	+	-	-	-
account_id	-	+	+	+	-	-
event_id	-	+	+	+	-	-
external_id	-	+	+	+	-	-
handler_id	-	+	+	+	-	-
top_similar_object_id	-	+	+	+	-	-
top_similar_external_id	-	+	+	+	-	-
top_matching_candidates_label	-	+	+	-	-	-
top_similar_object_similarity	-	-	-	+	-	-
face_id	-	+	+	+	-	-
gender	-	+	+	+	-	+
age	-	+	+	+	-	+
emotion	-	+	+	+	-	+
mask	-	+	+	+	-	+
ethnic_group	-	+	+	+	-	+
liveness	-	+	+	+	-	+
deepfake	-	+	+	+	-	+
city	-	+	+	-	-	+
area	-	+	+	-	-	+
district	-	+	+	-	-	+
street	-	+	+	-	-	+
house_number	-	+	+	-	-	+
geo_position	-	-	-	-	+	+
track_id	-	+	+	-	-	+
apparent_age	-	+	+	+	-	+
apparent_gender	-	+	+	+	-	+
sleeve_length	-	+	+	-	-	+
headwear_state	-	+	+	+	-	+
upper_clothing_colors	-	+	-	-	-	+
backpack_state	-	+	+	+	-	+
lower_garment_colors	-	+	-	-	-	+
headwear_apparent_color	-	+	+	-	-	+
lower_garment_type	-	+	+	-	-	+
shoes_apparent_color	-	+	+	-	-	+
meta.*	+	+	+	+	-	+

Array of objects (periods) >= 0 items

Specifies the period of event creation. All the events created during this period will be included in the statistics.

You can set the start and end of the period or only one of the bounds.

Note! You can specify only one period!

group_by

string (group_by)

Enables you to group events by creation time according to one of two ways:

Grouping by time intervals - number and dimension

Parameter value	Description
`1m`	one minute
`2h`	two hours
`7d`	seven days
`5w`	five weeks
`3M`	three months
`10y`	ten years

The frequency grouping - one of the following

Parameter value	Description
`monthOfYear`	by month of year
`weekOfYear`	by week of year
`dayOfYear`	by day of year
`dayOfMonth`	by day of month
`dayOfWeek`	by day of week
`hourOfDay`	by hours of day
`minuteOfHour`	by minutes of hour

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"targets": [{"column": "event_id",
"aggregator": "count"
},
{"column": "age",
"aggregator": "group_by"
},
{"column": "gender",
"aggregator": "group_by"
}
],
"filters": [{"column": "source",
"operator": "eq",
"value": "Main_hall_camera"
}
],
"period": [{"operator": "gt",
"value": "2020-02-04T00:00:00Z"
},
{"operator": "lt",
"value": "2020-02-06T00:00:00Z"
}
],
"group_by": "dayOfWeek"
}

Response samples

Content type

application/json

{"fields": ["Group by time: dayOfWeek",
"gender, aggregator 'group_by'",
"age, aggregator 'group_by'",
"event_id, aggregator 'count'"
],
"stats": [["Tuesday",
0,
22,
45
],
["Tuesday",
0,
27,
23
],
["Tuesday",
1,
27,
45
],
["Wednesday",
0,
25,
34
],
["Wednesday",
1,
33,
345
]
]
}

events statistics options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get events

Get events that satisfy filters.

Default filters for events:

create_time__lt - current date and time
create_time__gte - current date and time minus month

Default filters are not used if any of the following parameters are defined:

- list of event IDs (`event_ids`)
- lower event ID boundary (`event_id__gte`)
- upper event ID boundary (`event_id__lt`)
- lower create time boundary (`create_time__gte`)
- upper create time boundary (`create_time__lt`)

The target parameter determines field that will be shown for each event. If target is not set, the response will contain all the fields.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

target

Array of strings (events_targets)

Items Enum: "event_id" "account_id" "create_time" "end_time" "external_id" "handler_id" "stream_id" "source" "top_match" "match_result" "face_detections" "body_detections" "face_id" "attach_result" "gender" "age" "emotion" "ethnic_group" "tags" "user_data" "location" "mask" "liveness" "deepfake" "track_id" "body_basic_attributes" "upper_body" "lower_body" "accessories" "meta"

Example: target=create_time,event_id,face_detections

Comma-separated list of event fields. If set, each event from result will contain only specified fields, otherwise, events with all fields will be returned.

create_time__gte

string <date-time> (time)

Example: create_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object create_time.

create_time__lt

string <date-time> (time)

Example: create_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object create_time.

end_time__gte

string <date-time> (time)

Example: end_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object end_time.

end_time__lt

string <date-time> (time)

Example: end_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object end_time.

sources

string

Example: sources=cam1,cam2,null

Comma-separated list of sources or null. Each event from result will contain one of given sources.

stream_ids

string <list of uuid.>

Example: stream_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of stream IDs or null.

cities

string

Example: cities=Moscow,New York,null

Comma-separated list of cities or null. Each event from result will contain one of given cities in "location" parameter.

areas

string

Example: areas=CAD,Manhattan,null

Comma-separated list of areas or null. Each event from result will contain one of given areas in "location" parameter.

districts

string

Example: districts=Mitino,Midtown,null

Comma-separated list of districts or null. Each event from result will contain one of given districts in "location" parameter.

streets

string

Example: streets=Arbat,West 48th street,null

Comma-separated list of streets or null. Each event from result will contain one of given streets in "location" parameter.

house_numbers

string

Example: house_numbers=1,220,null

Comma-separated list of house numbers or null. Each event from result will contain one of given house numbers in "location" parameter.

longitude (number) or null_filter (string)

Example: origin_longitude=36.616

Longitude origin in degrees, a part of composite geo position filter or null for undefined geo position. Geo position filter is a bounding box specified by coordinates of its center (origin) and some delta. Geo position filter is considered as properly specified if both origin_longitude and origin_latitude are set, and considered as properly empty if neither of origin_longitude, origin_latitude, longitude_delta, latitude_delta is set. Null filter applied only if origin_longitude or origin_latitude is set to 'null', and longitude_delta and latitude_delta is not set.

latitude (number) or null_filter (string)

Example: origin_latitude=55.752

Latitude origin in degrees, a part of composite geo position filter or null for undefined geo position. Geo position filter is a bounding box specified by coordinates of its center (origin) and some delta. Geo position filter is considered as properly specified if both origin_longitude and origin_latitude are set, and considered as properly empty if neither of origin_longitude, origin_latitude, longitude_delta, latitude_delta is set. Null filter applied only if origin_longitude or origin_latitude is set to 'null', and longitude_delta and latitude_delta is not set.

longitude_delta

number (longitude_delta) [ 0 .. 90 ]

Default: 0.01

Example: longitude_delta=0.01

Longitude delta in degrees, a part of composite geo position filter.

Geo position filter is a bounding box specified by coordinates of its center (origin) and some delta.

Geo position filter is considered as properly specified if both origin_longitude and origin_latitude are set, and considered as properly empty if neither of origin_longitude, origin_latitude, longitude_delta, latitude_delta is set.

If both origin_longitude and origin_latitude are set and longitude_delta is not set - the default value is applied.

WARNING: Bounding boxes with a vertex or border on the International Date Line (IDL) or the North or South pole are not fully supported due to features of database spatial index - filter result may be unexpected.

NOTE: highly recommended for citywide use only.

latitude_delta

number (latitude_delta) [ 0 .. 90 ]

Default: 0.01

Example: latitude_delta=0.01

Latitude delta in degrees, a part of composite geo position filter.

Geo position filter is a bounding box specified by coordinates of its center (origin) and some delta.

Geo position filter is considered as properly specified if both origin_longitude and origin_latitude are set, and considered as properly empty if neither of origin_longitude, origin_latitude, longitude_delta, latitude_delta is set.

If both origin_longitude and origin_latitude are set and latitude_delta is not set - the default value is applied.

WARNING: Bounding boxes with a vertex or border on the International Date Line (IDL) or the North or South pole are not fully supported due to features of database spatial index - filter result may be unexpected.

NOTE: highly recommended for citywide use only.

top_matching_candidates_label

string

Example: top_matching_candidates_label=matching_label

Top matching candidates label. Each event from result will contain given label.

top_similar_object_ids

Array of strings (external_id) [ items <= 36 characters ]

Example: top_similar_object_ids=14159261415926

Comma-separated list of top similar object IDs. Each event from result will contain one of given top similar object IDs.

top_similar_external_ids

Array of strings <uuid> (uuid)

Example: top_similar_external_ids=557d54ec-29ad-4f3c-93b4-c9092ef12515

Comma-separated list of top similar external IDs. Each event from result will contain one of given top similar external IDs.

top_similar_object_similarity__gte

number

Example: top_similar_object_similarity__gte=0.5

Top similar object similarity lower included bound.

top_similar_object_similarity__lt

number

Example: top_similar_object_similarity__lt=0.5

Top similar object similarity upper excluded bound.

age__lt

integer

Example: age__lt=50

Age upper excluded bound.

age__gte

integer

Example: age__gte=50

Age lower included bound.

integer or null_filter (string)

Example: gender=1

Gender. 1 - male, 0 - female, "null" - null value.

emotions

string <list of integer and null (1, 2, 3, 4, 5, 6, 7, null)>

Example: emotions=1,2,3,null

Comma-separated list of predominant emotions or null. Each event from result will contain one of the given emotions.

emotions	value
anger	1
disgust	2
fear	3
happiness	4
neutral	5
sadness	6
surprise	7
not set	null

masks

string <list of integer and null (1, 2, 3, null)>

Example: masks=1,2,3,null

Comma-separated list of predominant masks or null. Each event from result will contain one of the given mask state.

mask	value
missing	1
medical_mask	2
occluded	3
not set	null

ethnic_groups

string <list of integer and null (1, 2, 3, 4, null)>

Example: ethnic_groups=1,2,null

Comma-separated list of dominant ethnic group or null. Each event from result will contain one of the given ethnic groups.

ethnicity	value
African american	1
Indian	2
Asian	3
Caucasian	4
Not set	null

liveness

string <list of integer and null (0, 1 ,2, null)>

Example: liveness=1,2,null

Comma-separated list of dominant liveness or null. Each event from result will contain one of the given liveness.

liveness	value
spoof	0
real	1
unknown	2
not set	null

deepfake

string <list of integer and null (0, 1, null)>

Example: deepfake=0,null

Comma-separated list of dominant deepfakes or null. Each event from result will contain one of the given deepfake.

deepfake	value
fake	0
real	1
not set	null

Array of integers or null_filter (string)

Example: apparent_gender=1

Comma-separated list of apparent gender: 0 - female, 1 - male, 2 - undefined, "null" - null value. Each event from result will contain one of the given states.

apparent_age__gte

integer [ 0 .. 100 ]

Example: apparent_age__gte=50

Apparent age lower included bound.

apparent_age__lt

integer [ 0 .. 100 ]

Example: apparent_age__lt=50

Apparent age upper excluded bound.

Array of integers or null_filter (string)

Example: headwear_states=1

Comma-separated list of headwear states: 0 - absent, 1 - present, 2 - undefined, "null" - null value. Each event from result will contain one of the given states.

Array of headwear_color (string) or null_filter (string)

Example: headwear_apparent_colors=white,undefined,null

Comma-separated list of headwear apparent colors or null value. Each event from result will contain one of the given states.

sleeve_lengths

Array of strings

Items Enum: "short" "long" "undefined" null

Example: sleeve_lengths=short,null

Comma-separated list of sleeve length states or null value. Each event from result will contain one of the given states.

Array of clothing_color (strings) or null_filter (string)

Example: upper_clothing_colors=black,white

Comma-separated list of upper clothing colors or null for not specified colors. Each event from result will contain at least one of the given clothing colors.

Array of clothing_color (strings) or null_filter (string)

Example: lower_garment_colors=black,white

Comma-separated list of lower garment colors. Each event from result will contain at least one of the given clothing colors.

lower_garment_types

Array of strings

Items Enum: "undefined" "trousers" "shorts" "skirt"

Example: lower_garment_types=trousers,undefined,null

Comma-separated list of lower garment types. Each event from result will contain one of the given types.

Array of shoes_color (string) or null_filter (string)

Example: shoes_apparent_colors=white,undefined,null

Comma-separated list of shoes apparent colors or null value. Each event from result will contain one of the given states.

Array of integers or null_filter (string)

Example: backpack_states=1

face_ids

string <list of uuid>

Example: face_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of face IDs.

event_ids

string <list of uuid.>

Example: event_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of event IDs.

event_id__gte

string <uuid.>

Example: event_id__gte=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Event ID lower included bound. Events in response will be sorted by their ids. If neither event_id__lt or event_id__gte is specified, the faces will be sorted by creation time.

event_id__lt

string <uuid.>

Example: event_id__lt=346a5645-ec89-4806-820a-dbcb6e0dc381

Event ID upper excluded bound. Events in response will be sorted by their ids. If neither event_id__lt or event_id__gte is specified, the faces will be sorted by creation time.

handler_ids

string <list of uuid.>

Example: handler_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of handler IDs.

external_ids

string

Example: external_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of external IDs.

user_data

string

Example: user_data=user_data_text

Find all objects with user_data similar to this parameter. You can specify only part of the user_data value for this filter.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

params = {
    "age__lt": 90,
    "cities": "New York,Moscow",
    "track_ids": "There_and_Back_Again,Around_the_World",
    "emotions": "3,4,5,6,7",
}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/events"

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"events": [{"create_time": "2020-10-11T09:11:41.674Z",
"end_time": "2020-10-11T09:11:42.674Z",
"event_id": "bd6df8ea-1df2-449d-b8e3-d1d40b215dc8",
"handler_id": "791f002e-919c-459d-b766-cba9f4130853",
"face_id": "e88b8804-fedb-4dc3-8a59-171caf416571",
"account_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"source": "3rd Avenue",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"top_match": {"face_id": "a3cd6fd9-75c2-47aa-b2cc-82d6f9792072",
"similarity": 0.67,
"label": "good guys",
"external_id": "external_id_1"
},
"match_result": [{"candidates": [{"event": {"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": null,
"user_data": "user data",
"handler_id": null,
"source": "cam_1",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e"
},
"similarity": 0.63
}
],
"label": "good guy"
}
],
"face_detections": [{"sample_id": "a3e8716f-70dc-42ad-8428-7a552e800a37",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2020-10-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": null
}
],
"body_detections": [{"sample_id": "a3e8716f-70dc-42ad-8428-7a552e800a37",
"detect_time": "2020-10-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"attach_result": ["24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"gender": 1,
"age": 27,
"emotion": 5,
"mask": 1,
"ethnic_group": 3,
"tags": ["good_event"
],
"user_data": "people are strange",
"location": {"city": "New York",
"area": "Manhattan",
"district": null,
"street": "West 48th street",
"house_number": "220",
"geo_position": {"latitude": -73.9906401596,
"longitude": 40.7627248564
}
},
"track_id": "e3ed4e18-2983-418d-879a-825e4517fc6c",
"liveness": 1,
"deepfake": 1,
"body_basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
},
"meta": {"foo": "bar"
}
},
{"account_id": "e3ed4e18-2983-418d-879a-825e4517fc6c",
"create_time": "2021-06-18T21:27:47.500116+03:00",
"end_time": "2021-06-18T21:27:47.500116+03:00",
"event_id": "2a7b475f-047a-442f-903f-eb0f632a5f25",
"external_id": "5d169198-7999-41bc-8233-6f2e752c2b1a",
"handler_id": "c79134a3-6395-432d-90a1-e877588a9c8f",
"source": "Zhang_Ziyi",
"face_id": "665bb0b9-c3d9-400b-86ab-31375e55405a",
"gender": 0,
"age": 27,
"emotion": 4,
"mask": 3,
"ethnic_group": 3,
"user_data": "Zhang_Ziyi",
"track_id": "42104c78-8983-4ab8-a2ac-24653a7ce66d",
"attach_result": ["35c01353-a71b-4f55-844d-2b4a001f4c5f"
],
"tags": ["Rihanna",
"Top_model"
],
"face_detections": [{"sample_id": "67487758-fa42-4913-81e1-3750a4a45657",
"detect_time": "2021-06-18T21:27:47.500116+03:00",
"detect_ts": 123.456,
"image_origin": null,
"detection": {"rect": {"x": 228,
"y": 200,
"width": 413,
"height": 522
}
}
}
],
"body_detections": null,
"location": {"city": "New York",
"area": "Manhattan",
"district": "unknown",
"street": null,
"house_number": null,
"geo_position": {"latitude": -73.9906401596,
"longitude": 40.7627248564
}
},
"match_result": [{"label": "11f14560-25c6-4727-b096-7e52a973e350",
"candidates": [{"similarity": 0.1134187654,
"face": {"face_id": "af836e01-7f0a-467d-9f91-e69909066f44",
"user_data": "02e2565a-bd20-46bb-89f4-f7656a8eb0b7",
"create_time": "2021-06-18T21:27:41.549079+03:00",
"external_id": "3f8c9b4e-0d96-4617-8698-94b4c7932c0b"
}
}
]
},
{"label": "ac75a600-8bf9-4a02-8bc1-daa8eeb0b41e",
"candidates": [{"similarity": 0.0251344983,
"face": {"face_id": "9a27acea-54ec-4f54-8491-12ffa74cc51a",
"user_data": "851520ac-28d4-445c-8ecd-ced96a949545",
"create_time": "2021-06-18T21:27:42.374622+03:00",
"external_id": "77db6ad5-2eac-46eb-9574-52b4cbdeb80c"
}
}
]
}
],
"top_match": {"face_id": "af836e01-7f0a-467d-9f91-e69909066f44",
"label": "11f14560-25c6-4727-b096-7e52a973e350",
"similarity": 0.1134187654,
"external_id": "external_id_1"
},
"liveness": 1,
"deepfake": 1,
"body_basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
},
"meta": null
}
]
}

events options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get event

Get event by ID.

The target parameter determines field that will be shown for specified event. If target is not set, the response will contain all the fields.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

event_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Event ID.

query Parameters

target

Array of strings (events_targets)

Items Enum: "event_id" "account_id" "create_time" "end_time" "external_id" "handler_id" "stream_id" "source" "top_match" "match_result" "face_detections" "body_detections" "face_id" "attach_result" "gender" "age" "emotion" "ethnic_group" "tags" "user_data" "location" "mask" "liveness" "deepfake" "track_id" "body_basic_attributes" "upper_body" "lower_body" "accessories" "meta"

Example: target=create_time,event_id,face_detections

Comma-separated list of event fields. If set, an event from result will contain only specified fields, otherwise, an event with all fields will be returned.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/handlers"
payload = {
    "description": "non_dynamic_handler",
    "policies": {},
    "handler_type": 0,
}
handlerId = requests.post(url, json=payload, headers=headers).json()["handler_id"]

with open("image.jpg", "rb") as image_file:
    image = image_file.read()

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
    "Luna-Event-Time": "2020-10-10T09:11:41.674Z",
}
url = f"{baseUri}/handlers/{handlerId}/events"

eventId = requests.post(
    url,
    headers=headers,
    data=image,
).json()["events"][0]["event_id"]

# We are waiting for the event to be created
time.sleep(5)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/events/{eventId}"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"create_time": "2020-10-11T09:11:41.674Z",
"end_time": "2020-10-11T09:11:41.674Z",
"event_id": "bd6df8ea-1df2-449d-b8e3-d1d40b215dc8",
"handler_id": "791f002e-919c-459d-b766-cba9f4130853",
"face_id": "e88b8804-fedb-4dc3-8a59-171caf416571",
"account_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"source": "3rd Avenue",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"top_match": {"face_id": "a3cd6fd9-75c2-47aa-b2cc-82d6f9792072",
"similarity": 0.67,
"label": "good guys",
"external_id": "external_id_1"
},
"match_result": [{"candidates": [{"event": {"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"external_id": null,
"user_data": "user data",
"handler_id": null,
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"source": "cam_1"
},
"similarity": 0.63
}
],
"label": "good guy"
}
],
"face_detections": [{"sample_id": "a3e8716f-70dc-42ad-8428-7a552e800a37",
"detection": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"detect_time": "2020-10-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": null
}
],
"body_detections": [{"sample_id": "a3e8716f-70dc-42ad-8428-7a552e800a37",
"detect_time": "2020-10-11T09:11:41.674Z",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"attach_result": ["24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"gender": 1,
"age": 27,
"emotion": 5,
"mask": 1,
"ethnic_group": 3,
"tags": ["good_event"
],
"user_data": "people are strange",
"location": {"city": "New York",
"area": "Manhattan",
"district": null,
"street": "West 48th street",
"house_number": "220",
"geo_position": {"latitude": -73.9906401596,
"longitude": 40.7627248564
}
},
"track_id": "e3ed4e18-2983-418d-879a-825e4517fc6c",
"body_basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
},
"meta": {"foo": "bar"
}
}

check if event exists

Check if event with event_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

event_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Event ID.

query Parameters

target

Array of strings (events_targets)

Items Enum: "event_id" "account_id" "create_time" "end_time" "external_id" "handler_id" "stream_id" "source" "top_match" "match_result" "face_detections" "body_detections" "face_id" "attach_result" "gender" "age" "emotion" "ethnic_group" "tags" "user_data" "location" "mask" "liveness" "deepfake" "track_id" "body_basic_attributes" "upper_body" "lower_body" "accessories" "meta"

Example: target=create_time,event_id,face_detections

Comma-separated list of event fields. If set, an event from result will contain only specified fields, otherwise, an event with all fields will be returned.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/handlers"
payload = {
    "description": "non_dynamic_handler",
    "policies": {},
    "handler_type": 0,
}
handlerId = requests.post(url, json=payload, headers=headers).json()["handler_id"]

# emit event
with open("image.jpg", "rb") as image_file:
    image = image_file.read()

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
    "Content-Type": "image/jpeg",
    "Luna-Event-Time": "2020-10-10T09:11:41.674Z",
}
url = f"{baseUri}/handlers/{handlerId}/events"

eventId = requests.post(
    url,
    headers=headers,
    data=image,
).json()["events"][0]["event_id"]

# We are waiting for the event to be created
time.sleep(5)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/events/{eventId}"

response = requests.head(url, headers=headers)

print(response.status_code)

event options

Get options for the resource.

path Parameters

event_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Event ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

task processing

clustering task

Create a clustering task.

The Filters section specifies which faces (or events) should be added to the cluster. The filters are combined with logical AND.

Available filters depend on the object type: events or faces.

You can receive a report about the finished clustering task using the reporter task.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string User data provided for the current task.
required	object (clustering_task_content) Clustering task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "clustering faces",
"content": {"filters": {"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"account_id": "string"
},
"objects_type": "faces",
"params": {"use_track_info": 0
},
"threshold": 0.5,
"descriptor": {"type": "face"
},
"limit": 3
}
}

Response samples

Content type

application/json

{"task_id": 17
}

clustering options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

reporter task

Create a task report in CSV format.

Now the report is only created for clustering tasks.

The report contains additional information about clustering objects (faces or events). You can specify additional information that will be added to the report. The first and the second columns in the report always correspond to a cluster number and an object ID.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results. The result is returned in ZIP archive, which contains a CSV file. If you set the save_images parameter, then the ZIP archive will also contain a folder with images.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string Provided user data for the current task.
required	object (ReporterTaskContent) Reporter task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "report clustering events from cam1",
"content": {"columns": ["face_id",
"user_data",
"create_time"
],
"csv_delimiter": "$",
"save_images": 1,
"filters": {"task_id": 146,
"account_id": "string"
}
}
}

Response samples

Content type

application/json

{"task_id": 17
}

reporter options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

exporter task

Collect event and/or face data and export them from LP to a CSV file. The file rows represent requested objects. Corresponding samples (if they were requested) are also returned.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results. The result is returned in ZIP archive, which contains a CSV file. If you set the save_images parameter, then the ZIP archive will also contain a folder with images.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string (task_description) <= 128 characters Task description.
required	any Exporter task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "task description",
"content": {"filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
},
"objects_type": "string",
"columns": ["face_id",
"user_data",
"create_time"
],
"descriptor": {"type": "face"
},
"csv_delimiter": "$",
"save_images": 0
}
}

Response samples

Content type

application/json

{"task_id": 31
}

exporter options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

linker task

Create a linker task.

The task enables you to attach faces to the specified list according to the filters.

You can use faces or events as objects for the task. When events are used, new face is created for each of the events.

A list is required for the task processing:

If you specified a list, the Tasks service checks its existence and displays an error if the list is not found.
If you set new list creation using create_list = 1, new list is created.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

If luna-image-store is disabled no subtask/task result will be stored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string User data provided for the current task.
required	object (linker_task_content) Linker task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "linker task one",
"content": {"create_list": 1,
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"user_data": "list of good persons",
"objects_type": "faces",
"filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
}
}
}

Response samples

Content type

application/json

{"task_id": 29
}

linker options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

garbage collection task

Create a garbage collection task.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

WARNING: If you perform the task for faces with the remove_samples flag disabled, then the only way to delete samples is to execute the "remove face/body sample" resource.

If luna-image-store is disabled no subtask/task result will be stored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

One of

description	string User data provided for the current task.
required	object (GcEventsTaskContent) Garbage collection task content to remove events.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

gc_events_task

{"description": "gc task one",
"content": {"target": "events",
"filters": {"create_time__lt": "2018-08-11T09:11:41.674Z",
"insert_time__lt": "2018-08-11T09:11:41.674Z",
"handler_id": "string"
},
"store_results": true,
"remove_samples": false,
"remove_image_origins": false
}
}

Response samples

Content type

application/json

{"task_id": 25
}

gc options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

cross-matching task

Create a cross-matching task.

The cross-matching task enables you to compare references (faces, attributes or events) with candidates (faces, attributes or events) according to the specified filters.

All the references are matched with all the candidates.

You can limit the number of candidates returned in matching results and set the minimum acceptable similarity threshold.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string User data provided for the current task.
required	object (CrossMatchTaskContent) Cross match task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "matching visitors with the list of VIP customers",
"content": {"filters": {"reference_filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"gender": 1,
"sources": "Main_hall_camera"
},
"candidate_filters": {"create_time__gte": "2018-02-11T09:11:41.674Z",
"create_time__lt": "2020-02-12T09:11:41.674Z",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
},
"reference_type": "events",
"candidate_type": "faces"
},
"threshold": 0.5,
"limit": 3
}
}

Response samples

Content type

application/json

{"task_id": 15
}

cross match options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

ROC-curve calculating task

Create a ROC-curve calculating task.

ROC (or Receiver Operating Characteristic) is a performance measurement for the classification problem at various threshold settings. The ROC-curve is plotted with TPR (True Positive Rate) against the FPR (False Positive Rate).

TPR is a true positive match pair count divided by a count of total expected positive match pairs, and FPR is a false positive match pair count divided by a count of total expected negative match pairs. Each point (FPR, TPR) of the ROC-cure corresponds to a certain similarity threshold.

The model performance is determined by looking at the area under the ROC-curve (or AUC), the ROC-curve and the secondary main diagonal intersection point, where type I and type II error rates are equal. The model performance is also determined by getting into the top-N probability, i.e. probability of getting a positive match pair into the top-N for any match result group sorted by similarity.

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

Objects to be processed must belong to the user account making the request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string User data provided for the current task.
required	object (roc_task_content) ROC-curve calculating task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "matching famous people with customers",
"content": {"markup": [{"face_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"label": 12
},
{"face_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"label": 12
}
],
"filters": {"account_id": "string"
},
"threshold_hit_top": 0.95,
"limit": 100,
"key_FPRs": [0.000001,
0.001
]
}
}

Response samples

Content type

application/json

{"task_id": 14
}

roc options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

estimator task

Create an estimator task.

Task allows to process images using established policies. Policies can be specified in the request or use saved ones by passing the handler ID.

The resource can accept three types of sources with images for processing:

ZIP archive
S3-like storage
Network disk
FTP server
Samba

Use the GET request on resource "/6/tasks/{task_id}/result" to receive the task results.

If there are no results of the created task and error "Object not found" is returned, use the GET request on resource "/6/tasks/errors/{error_id}" to receive the task errors.

WARNING: Check handler storage_policy before a task start, notification_policy and event_policy enable by default.

Objects to be processed must belong to the user account making the request.

If luna-image-store is disabled no subtask/task result will be stored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string Provided user data for current task.
required	object (estimator_task_content) Estimator task content.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

estimate_from_zip_archive

{"description": "estimator task with zip archive",
"content": {"handler": {"handler_id": "c42ad7cb-9078-4be4-8457-4d3c744477df"
},
"source": {"source_type": "zip",
"reference": {"url": "http://example.com/123.zip",
"prefix": "folder_in_archive/some_prefix",
"postfix": ".jpg"
},
"recursive": true,
"authorization": {"password": 123456
},
"image_type": 1
}
}
}

Response samples

Content type

application/json

{"task_id": 123
}

estimator options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

lambda task

Create new lambda task.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

description	string Default: "" provided user data for current task.
required	object (lambda_task_content) lambda task content

Responses

Request samples

Payload

Content type

application/json

{"description": "lambda task one",
"content": {"lambda_id": "string",
"lambda task content fields1": null,
"lambda task content fields2": null
}
}

Response samples

Content type

application/json

{"task_id": 123
}

lambda task options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

task info

get tasks

Get tasks according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

page

integer >= 1

Default: 1

Page number.

page_size

integer [ 1 .. 1000 ]

Default: 10

Number of items on page.

create_time__lt

string <date-time> (time)

Example: create_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object create_time.

create_time__gte

string <date-time> (time)

Example: create_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object create_time.

end_time__lt

string <date-time> (time)

Example: end_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object end_time.

end_time__gte

string <date-time> (time)

Example: end_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object end_time.

task_ids

string <comma-separate task ids> (taskIds)

Example: task_ids=1,2,3

Comma-separated task IDs.

task_type

integer (task_type)

Enum: 0 1 2 3 4 5 6 7 8 9 10

Example: task_type=1

Task type.

task type	value
unknown	0
linker	1
clusterization	2
report	3
garbage collection	4
additional extract	5
cross match	6
roc-curve calculation	7
export objects	8
estimate data	9
lambda task	10

task_status

integer (taskStatus)

Enum: 0 1 2 3 4 5

Example: task_status=1

Task status.

task status	value
pending	0
in progress	1
cancelled	2
failed	3
collect results	4
done	5

schedule_id

integer (schedule_id) >= 1

Schedule according to which the task was created

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

params = {
    "task_id": taskId,
    "task_type": 4,
    "task_status": 5,
    "create_time__gte": "2018-08-11T09:11:41.674Z",
    "page": 1,
}

url = f"{baseUri}/tasks"
response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"tasks": [{"task_id": 27,
"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"end_time": null,
"last_update_time": "2018-08-11T09:11:41.674Z",
"task_type": 6,
"task_status": 1,
"result_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"count_task_parts_done": 10,
"count_task_parts_all": 100,
"content": {"filters": {"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"reference_type": "events",
"candidate_type": "faces",
"reference_filters": {"gender": 1,
"sources": ["Main_hall_camera"
]
},
"candidate_filters": {"attribute_ids": ["83914110-cba3-46da-8dbe-e6e7a7aa2466",
"9027e290-db5a-43b0-9454-848ad377d428"
]
}
},
"threshold": 0.5,
"limit": 3
},
"description": "task description",
"schedule_id": 13
},
{"task_id": 13,
"create_time": "2018-10-11T09:11:41.755Z",
"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"end_time": "2018-10-11T10:15:41.700Z",
"last_update_time": "2018-10-11T09:11:41.755Z",
"task_type": 2,
"task_status": 5,
"result_id": "3d69b8c3-8465-4eca-8a27-c5a30cd83e3d",
"count_task_parts_done": 10,
"count_task_parts_all": 10,
"content": {"filters": {"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
},
"objects_type": "events",
"threshold": 0.61,
"params": {"use_track_info": 1
},
"descriptor": {"type": "face"
}
},
"description": "task description",
"schedule_id": 13
}
]
}

tasks options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get tasks count

Count tasks according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

create_time__lt

string <date-time> (time)

Example: create_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object create_time.

create_time__gte

string <date-time> (time)

Example: create_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object create_time.

end_time__lt

string <date-time> (time)

Example: end_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object end_time.

end_time__gte

string <date-time> (time)

Example: end_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object end_time.

task_ids

string <comma-separate task ids> (taskIds)

Example: task_ids=1,2,3

Comma-separated task IDs.

task_type

integer (task_type)

Enum: 0 1 2 3 4 5 6 7 8 9 10

Example: task_type=1

Task type.

task type	value
unknown	0
linker	1
clusterization	2
report	3
garbage collection	4
additional extract	5
cross match	6
roc-curve calculation	7
export objects	8
estimate data	9
lambda task	10

task_status

integer (taskStatus)

Enum: 0 1 2 3 4 5

Example: task_status=1

Task status.

task status	value
pending	0
in progress	1
cancelled	2
failed	3
collect results	4
done	5

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

schedule_id

integer (schedule_id) >= 1

Schedule according to which the task was created

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

params = {
    "task_id": taskId,
    "task_type": 4,
    "task_status": 5,
    "create_time__gte": "2018-08-11T09:11:41.674Z",
    "page": 1,
}

url = f"{baseUri}/tasks/count"
response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"count": 13
}

tasks count options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get task

Get task by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"task_id": 13,
"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"create_time": "2018-08-11T09:11:41.674Z",
"end_time": "2018-08-11T10:11:41.674Z",
"last_update_time": "2018-08-11T10:11:41.674Z",
"task_type": 1,
"task_status": 5,
"result_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"count_task_parts_done": 10,
"count_task_parts_all": 10,
"content": {"filters": {"account_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
},
"objects_type": "faces",
"user_data": "some info",
"list_id": "8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
"create_list": 1
},
"description": "task description"
}

cancel task

Cancel task by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}"
response = requests.patch(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

delete task

Delete a task and the task results by the task ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}"
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

Example

bad_query_param

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

task options

Get options for the resource.

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get task result

Get task result by the task ID.

In addition to the result of the task, the occurred errors can be returned in the response.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}/result"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

Example

gc task result

{"result": [{"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"samples": ["ceaef36e-944f-4b80-a110-96b7d82b8b58"
]
}
],
"errors": [ ]
}

task result options

Get options for the resource.

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get subtasks

Get subtasks of a task by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/gc"
payload = {"content": {"target": "events"}}
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}/subtasks"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"subtasks": [{"subtask_id": 39,
"task_id": 39,
"result_id": "d4dd7ffc-b822-4ed1-88ab-dcce36ae6739",
"create_time": "2020-06-10T01:09:53.973246+03:00",
"end_time": "2020-06-10T01:09:54.014438+03:00",
"subtask_status": 4,
"content": {"target": "events",
"filters": {"account_id": "448f50d1-19cd-4c77-9c2f-f6358b2dd385"
}
}
},
{"subtask_id": 1,
"task_id": 1,
"result_id": null,
"create_time": "2021-06-18T22:02:00.435144+03:00",
"end_time": "2021-06-18T22:02:00.488094+03:00",
"subtask_status": 3,
"content": {"filters": {"list_id": "d94726c8-55c1-4acb-9ee3-7c40b69e1120",
"account_id": "448f50d1-19cd-4c77-9c2f-f6358b2dd385"
},
"objects_type": "faces",
"descriptor": {"type": "face"
}
}
}
]
}

subtasks options

Get options for the resource.

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

task errors

get task errors

Get errors of a task by the task ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

task_id

required

integer >= 1

Task ID.

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time
from uuid import uuid4

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

payload = {
    "description": "matching famous people with customers",
    "content": {
        "markup": [
            {"face_id": str(uuid4()), "label": 1},
            {"face_id": str(uuid4()), "label": 2},
        ],
    },
}

url = f"{baseUri}/tasks/roc"
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

url = f"{baseUri}/tasks/{taskId}/errors"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"errors": [{"error_id": 5808750,
"task_id": 14980,
"subtask_id": 69825,
"error_code": 28010,
"description": "Objects not found",
"detail": "Objects for clustering not found (empty set)",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-28010",
"additional_info": null,
"error_time": "2019-04-29T10:53:42.417396+03:00"
},
{"error_id": 9,
"task_id": 41,
"subtask_id": 41,
"error_code": 13003,
"description": "Object not found",
"detail": "Image with id 'a75ddc76-e37e-45f5-9a7a-93e4001208fb' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-13003",
"additional_info": "f2d470e7-03c1-4cb2-84b5-ea480f00b1f0",
"error_time": "2020-05-09T04:10:35.279253+03:00"
}
]
}

task errors options

Get options for the resource.

path Parameters

task_id

required

integer >= 1

Task ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get errors

Get errors according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

page

integer >= 1

Default: 1

Page number.

page_size

integer [ 1 .. 1000 ]

Default: 10

Number of items on page.

task_ids

string <comma-separate task ids> (taskIds)

Example: task_ids=1,2,3

Comma-separated task IDs.

error_code

integer (error_code)

Error code.

error_ids

string <comma-separate task ids> (errorIds) non-empty

Example: error_ids=4,5,6

Comma-separated error IDs.

error_time__lt

string <date-time> (time)

Example: error_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object error_time.

error_time__gte

string <date-time> (time)

Example: error_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object error_time.

task_type

integer (task_type)

Enum: 0 1 2 3 4 5 6 7 8 9 10

Example: task_type=1

Task type.

task type	value
unknown	0
linker	1
clusterization	2
report	3
garbage collection	4
additional extract	5
cross match	6
roc-curve calculation	7
export objects	8
estimate data	9
lambda task	10

status_code

integer (status_code) [ 400 .. 599 ]

Example: status_code=500

HTTP status code.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time
from uuid import uuid4

baseUri = "http://127.0.0.1:5000/6"

# create bad task
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "description": "matching famous people with customers",
    "content": {
        "markup": [
            {"face_id": str(uuid4()), "label": 1},
            {"face_id": str(uuid4()), "label": 2},
        ],
    },
}
url = f"{baseUri}/tasks/roc"
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

# get tasks error id list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/{taskId}/errors"
response = requests.get(url, headers=headers)
errorIds = [
    str(error["error_id"]) for error in response.json()["errors"]
]

# get error according to the filters
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "errors": [
        {
            "error_id": ",".join(errorIds),
            "task_id": taskId,
            "error_time__gte": "2018-08-11T09:11:41.674Z",
        }
    ]
}

url = f"{baseUri}/tasks/errors"
response = requests.get(url, headers=headers, json=payload)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"errors": [{"error_id": 5808750,
"task_id": 14980,
"subtask_id": 69825,
"error_code": 28010,
"description": "Objects not found",
"detail": "Objects for clustering not found (empty set)",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-28010",
"additional_info": null,
"error_time": "2019-04-29T10:53:42.417396+03:00"
},
{"error_id": 9,
"task_id": 41,
"subtask_id": 41,
"error_code": 13003,
"description": "Object not found",
"detail": "Image with id 'a75ddc76-e37e-45f5-9a7a-93e4001208fb' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-13003",
"additional_info": "f2d470e7-03c1-4cb2-84b5-ea480f00b1f0",
"error_time": "2020-05-09T04:10:35.279253+03:00"
}
]
}

errors options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get errors count

Count errors according to the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

error_time__lt

string <date-time> (time)

Example: error_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object error_time.

error_time__gte

string <date-time> (time)

Example: error_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object error_time.

task_type

integer (task_type)

Enum: 0 1 2 3 4 5 6 7 8 9 10

Example: task_type=1

Task type.

task type	value
unknown	0
linker	1
clusterization	2
report	3
garbage collection	4
additional extract	5
cross match	6
roc-curve calculation	7
export objects	8
estimate data	9
lambda task	10

status_code

integer (status_code) [ 400 .. 599 ]

Example: status_code=500

HTTP status code.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time
from uuid import uuid4

baseUri = "http://127.0.0.1:5000/6"

# create bad task
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "description": "matching famous people with customers",
    "content": {
        "markup": [
            {"face_id": str(uuid4()), "label": 1},
            {"face_id": str(uuid4()), "label": 2},
        ],
    },
}
url = f"{baseUri}/tasks/roc"
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

# get tasks error id list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/{taskId}/errors"
response = requests.get(url, headers=headers)
errorIds = [
    str(error["error_id"]) for error in response.json()["errors"]
]

# get error count
headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "errors": [
        {
            "error_id": ",".join(errorIds),
            "task_id": taskId,
            "error_time__gte": "2018-08-11T09:11:41.674Z",
        }
    ]
}

url = f"{baseUri}/tasks/errors/count"
response = requests.get(url, headers=headers, json=payload)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"count": 18
}

task errors count options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get error

Get error by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

error_id

required

integer >= 1

Error ID.

query Parameters

error_id

integer (errorId)

Example: error_id=10

Error ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests
import time
from uuid import uuid4

baseUri = "http://127.0.0.1:5000/6"

# create bad task
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
payload = {
    "description": "matching famous people with customers",
    "content": {
        "markup": [
            {"face_id": str(uuid4()), "label": 1},
            {"face_id": str(uuid4()), "label": 2},
        ],
    },
}
url = f"{baseUri}/tasks/roc"
taskId = requests.post(url, headers=headers, json=payload).json()["task_id"]

# wait for tasks to complete
time.sleep(5)

# get tasks error id list
headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/{taskId}/errors"
response = requests.get(url, headers=headers)
errorId = [
    str(error["error_id"]) for error in response.json()["errors"]
][0]

url = f"{baseUri}/tasks/errors/{errorId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"error_id": 5808750,
"task_id": 14980,
"subtask_id": 69825,
"error_code": 28010,
"description": "Objects not found",
"detail": "Objects for clustering not found (empty set)",
"additional_info": null,
"error_time": "2019-04-29T10:53:42.417396+03:00",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-28010"
}

error options

Get options for the resource.

path Parameters

error_id

required

integer >= 1

Error ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

task schedules

create tasks schedule

Create a new task schedule.

Execution of scheduled tasks will be regulated according to the trigger and optionally starts one task immediately (see start_immediately parameter in behavior section).

No task from the schedule will be executed if the previous task has not yet been completed.

Permissions for task objects.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" Content type is `application/json`.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

required	any (task_schedulable) Task schedule.
required	object (schedule_trigger) Task schedule trigger.
	object (schedule_behaviour) Schedule behaviour parameters.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

Example

gc task. remove events older than 30 days

{"task": {"task_type": 4,
"content": {"target": "events",
"filters": {"create_time__lt": "now-30d"
},
"remove_samples": true,
"remove_image_origins": true
}
},
"trigger": {"cron": "30 5 * * *",
"cron_timezone": "utc"
},
"behaviour": {"start_immediately": false,
"create_stopped": false
}
}

Response samples

Content type

application/json

{"schedule_id": 1
}

get tasks schedules

Get tasks schedules with filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

page

integer >= 1

Default: 1

Page number.

page_size

integer [ 1 .. 1000 ]

Default: 10

Number of items on page.

task_type

integer (task_type_schedulable_reply)

Enum: 1 2 3 4 5 6 7 8 9 10

Example: task_type=1

Task type.

Task type	Value
Linker	1
Clusterization	2
Report	3
Garbage collection	4
Additional extract	5
Cross match	6
Roc-curve calculation	7
Export objects	8
estimator	9
lambda	10

create_time__lt

string <date-time> (time)

Example: create_time__lt=2018-08-11T09:11:41.674Z

Upper bound for object create_time.

create_time__gte

string <date-time> (time)

Example: create_time__gte=2018-08-11T09:11:41.674Z

Lower included bound for object create_time.

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
params = {
        "create_time__lt": "2018-08-11T09:11:41.674Z", 
        "create_time_gte": "2050-08-11T09:11:41.674Z",
        "task_type": 1,
}
url = f"{baseUri}/tasks/schedules"
response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

[{"schedule_id": 1,
"task_ids": [1,
2,
3
],
"account_id": "string",
"task": {"task_type": 1,
"content": {"filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"account_id": "string",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
},
"create_list": 1,
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"user_data": "100-00-12",
"objects_type": "faces"
}
},
"trigger": {"cron": "5 4 * * *",
"cron_timezone": "utc"
},
"status": "running",
"next_run_time": "2018-08-11T09:11:41.674Z",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}
]

schedules options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get tasks schedule

Get tasks schedule by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

schedule_id

required

integer (schedule_id) >= 1

Schedule according to which the task was created

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

payload = {
    "task": {
        "task_type": 1,
        "content": {
            "create_list": 1,
            "objects_type": "faces",
            "filters": {
                "create_time__gte": "2018-08-11T09:11:41.674Z"
            },
        },
    },
    "trigger": {"cron": "5 4 * * *", "cron_timezone": "utc"},
    "behaviour": {"start_immediately": False, "create_stopped": False}
    
}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/schedules"
response = requests.post(url, headers=headers, json=payload)
scheduleId = response.json()["schedule_id"]

url = f"{baseUri}/tasks/schedules/{scheduleId}"
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"schedule_id": 1,
"task_ids": [1,
2,
3
],
"account_id": "string",
"task": {"task_type": 1,
"content": {"filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"account_id": "string",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
},
"create_list": 1,
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"user_data": "100-00-12",
"objects_type": "faces"
}
},
"trigger": {"cron": "5 4 * * *",
"cron_timezone": "utc"
},
"status": "running",
"next_run_time": "2018-08-11T09:11:41.674Z",
"create_time": "2018-08-11T09:11:41.674Z",
"last_update_time": "2018-08-11T09:11:41.674Z"
}

replace tasks schedule

Replace tasks schedule:

if any task created by old schedule is running, it will be cancelled
schedule parameters will be replaced with the new ones
tasks will be executed according to the new schedule

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

schedule_id

required

integer (schedule_id) >= 1

Schedule according to which the task was created

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

required	any (task_schedulable) Task schedule.
required	object (schedule_trigger) Task schedule trigger.
	object (schedule_behaviour) Schedule behaviour parameters.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"task": {"task_type": 1,
"content": {"create_list": 1,
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"user_data": "list of good persons",
"objects_type": "faces",
"filters": {"create_time__gte": "2018-08-11T09:11:41.674Z",
"create_time__lt": "2018-08-11T09:11:41.674Z",
"face_ids": ["557d54ec-29ad-4f3c-93b4-c9092ef12515"
],
"external_ids": ["14159261415926"
],
"user_data": "info",
"face_id__gte": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"face_id__lt": "string",
"list_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515"
}
}
},
"trigger": {"cron": "5 4 * * *",
"cron_timezone": "utc"
},
"behaviour": {"start_immediately": false,
"create_stopped": false
}
}

Response samples

Content type

application/json

{"schedule_id": 1
}

patch tasks schedule

Pause/start tasks schedule.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

schedule_id

required

integer (schedule_id) >= 1

Schedule according to which the task was created

query Parameters

action

required

string

Enum: "pause" "start"

Pause/start tasks schedule.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

# create list
url = f"{baseUri}/lists"
listId = requests.post(url, headers=headers).json()["list_id"]

# create face
url = f"{baseUri}/faces"
faceId = requests.post(url, headers=headers).json()["face_id"]

payload = {
    "task": {
        "task_type": 1,
        "content": {
            "create_list": 0,
            "objects_type": "faces",
            "list_id": listId,
            "filters": {
                "face_ids": [faceId],
            },
        },
    },
    "trigger": {"cron": "5 4 * * *", "cron_timezone": "utc"},
    "behaviour": {"start_immediately": False, "create_stopped": False}

}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/schedules"
response = requests.post(url, headers=headers, json=payload)
scheduleId = response.json()["schedule_id"]

# Patch schedule
params = {"action": "pause"}
response = requests.patch(url + f"/{scheduleId}", headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

delete tasks schedule

Delete tasks schedule.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

schedule_id

required

integer (schedule_id) >= 1

Schedule according to which the task was created

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}

# create list
url = f"{baseUri}/lists"
listId = requests.post(url, headers=headers).json()["list_id"]

# create face
url = f"{baseUri}/faces"
faceId = requests.post(url, headers=headers).json()["face_id"]

payload = {
    "task": {
        "task_type": 1,
        "content": {
            "create_list": 0,
            "objects_type": "faces",
            "list_id": listId,
            "filters": {
                "face_ids": [faceId],
            },
        },
    },
    "trigger": {"cron": "5 4 * * *", "cron_timezone": "utc"},
    "behaviour": {"start_immediately": False, "create_stopped": False}

}

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/tasks/schedules"
response = requests.post(url, headers=headers, json=payload)
scheduleId = response.json()["schedule_id"]

# Delete schedule
payload = {"action": "pause"}
response = requests.delete(url + f"/{scheduleId}", headers=headers, json=payload)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

schedule options

Get options for the resource.

path Parameters

schedule_id

required

integer (schedule_id) >= 1

Schedule according to which the task was created

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

verifiers

create verifier

Create a verifier.

The verifier determines a list of rules for processing and verification of input images.

You can set:

verification_threshold
detect_policy
extract_policy
storage_policy for attributes and face samples.

The created handler can be used in "raw verification" and "perform verification" requests.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

description	string <= 128 characters Verifier user description.
	object

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "strict verifier",
"policies": {"verification_threshold": 0.9,
"detect_policy": {"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_glasses": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [ ],
"estimate_liveness": {"estimate": 0,
"liveness_threshold": 0.5,
"quality_threshold": 0.5
},
"liveness_states": [ ],
"estimate_deepfake": {"estimate": 0,
"real_threshold": 0.5,
"mode": 1
},
"deepfake_states": [ ],
"face_quality": {"estimate": 0,
"filter": 0,
"checks": {"image_format": {"estimate": 0,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"specularity_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"blurriness_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"dark_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"light_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_roll": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_smiling": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_occluded": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_open": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"glasses": {"estimate": 0,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 0,
"threshold": ["open"
]
},
"right_eye": {"estimate": 0,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 0,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 0,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 0,
"threshold": {"min": 91.1,
"max": 92.2
}
},
"image_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 0,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 0
}
},
"indent_left": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_right": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_upper": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_lower": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"image_size": {"estimate": 0,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 0,
"threshold": ["neutral"
]
},
"headwear_type": {"estimate": 0,
"threshold": ["none"
]
},
"smile_properties": {"estimate": 0,
"threshold": ["none"
]
},
"face_color_type": {"estimate": 0,
"threshold": ["color"
]
},
"natural_light": {"estimate": 0,
"threshold": 0
},
"red_eyes": {"estimate": 0,
"threshold": 0
},
"radial_distortion": {"estimate": 0,
"threshold": 0
},
"illumination_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 0,
"threshold": {"min": 0.2,
"max": 1
}
},
"shoulders_position": {"estimate": 0,
"threshold": ["parallel"
]
}
}
}
},
"extract_policy": {"extract_basic_attributes": 0,
"fd_score_threshold": 0.7
},
"storage_policy": {"attribute_policy": {"store_attribute": 0
},
"face_sample_policy": {"store_sample": 0
}
}
}
}

Response samples

Content type

application/json

{"verifier_id": "b5d6fd45-fcca-453d-ac05-3e594054b813",
"url": "/6/verifiers/b5d6fd45-fcca-453d-ac05-3e594054b813",
"external_url": "http://127.0.0.1:5000/6/verifiers/b5d6fd45-fcca-453d-ac05-3e594054b813"
}

get verifiers

Get verifiers by filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
description	string Records with descriptions similar to this parameter will be processed.
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/verifiers"

payload = {
    "description": "new verifier",
    "policies": {
        "verification_threshold": 0.5,
        "detect_policy": {
            "estimate_mask": 1
        },
        "extract_policy": {
            "extract_basic_attributes": 1
        },
        "storage_policy": {
            "attribute_policy": {
                "store_attribute": 1
            },
            "face_sample_policy": {
                "store_sample": 1
            }
        }
    }
}

# create verifier
requests.post(url, json=payload, headers=headers)

# get verifiers
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

[{"verifier_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"description": "simple verifier",
"policies": {"verification_threshold": 0.99,
"detect_policy": {"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [1
],
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
}
}
}
},
"extract_policy": {"extract_basic_attributes": 1,
"fd_score_threshold": 0.7
},
"storage_policy": {"attribute_policy": {"store_attribute": 0
},
"face_sample_policy": {"store_sample": 0
}
}
},
"create_time": "2019-08-24T14:15:22Z",
"last_update_time": "2019-08-24T14:15:22Z",
"version": 111
},
{"verifier_id": "a48609f8-860f-412d-abab-9abfdb517e67",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"create_time": "2021-06-18T22:05:06.324756+03:00",
"last_update_time": "2021-06-18T22:05:06.324756+03:00",
"description": "AAAac93c7fe-cda1-44b3-bcac-2421e3cb5924BBB",
"policies": {"detect_policy": {"multiface_policy": 1,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"pitch_threshold": null,
"roll_threshold": null,
"yaw_threshold": null,
"mask_states": null,
"estimate_liveness": {"estimate": 0,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": null,
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
}
}
}
},
"extract_policy": {"extract_basic_attributes": 0,
"fd_score_threshold": 0
},
"storage_policy": {"attribute_policy": {"store_attribute": 0
},
"face_sample_policy": {"store_sample": 0
}
},
"verification_threshold": 0.9
},
"version": 0
}
]

verifiers options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

raw verification

This request performs verification of input descriptors.

"Similarity" and "verification status" are returned for each candidate.

"Verification status" is "True" if the received similarity is greater than the verification_threshold (specified in the verifier handler). Hence, the reference and the candidate are considered the same person.

You should specify descriptors as references and candidates for this request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "application/json" "application/msgpack" Format of a request body data.
Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Request Body schema:
application/json

required	Array of xpk_file_entity_base64 (object) or sdk_descriptor_entity_base64 (object) or raw_descriptor_entity_base64 (object) non-empty Reference list for verification.
required	Array of xpk_file_entity_base64 (object) or sdk_descriptor_entity_base64 (object) or raw_descriptor_entity_base64 (object) non-empty Candidates for verification.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"references": [{"data": "string",
"id": "string",
"type": "xpk_file"
}
],
"candidates": [{"data": "string",
"id": "string",
"type": "xpk_file"
}
]
}

Response samples

Content type

application/json

{"matches": [{"reference_id": "123456s",
"matches": [{"candidate_id": "31415926",
"similarity": 0.5,
"status": true
}
]
},
{"reference_id": "raw-1",
"matches": [{"candidate_id": "candidate",
"similarity": 0.0210287365,
"status": false
},
{"candidate_id": "sdk",
"similarity": 0.0210287365,
"status": false
},
{"candidate_id": "xpk",
"similarity": 0.0210287365,
"status": false
}
]
}
]
}

raw verification options

Get options for the resource.

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

perform verification

Verify given images and/or descriptors against specified objects set: faces IDs, events IDs, external IDs.

"Similarity" and "verification status" are returned for each candidate.

"Verification status" is "True" if the received similarity is greater than the verification_threshold (specified in the verifier handler). Hence, the reference and the candidate are considered the same person.

The input images are processed according to the specified policies and the received information is returned in the response.

Objects to be processed must belong to the user account making the request.

Notes for incoming data:

face or body bounding boxes passed with face or body warped image will be ignored.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

query Parameters

face_ids	string <list of uuid> Example: face_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of face IDs.
event_ids	string <list of uuid.> Example: event_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of event IDs.
attribute_ids	string <list of uuid> Example: attribute_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of attribute IDs.
external_ids	string Example: external_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381 Comma-separated list of external IDs.
image_type	integer Default: 0 Enum: 0 1 Image type of input image. 0 - raw image, 1 - face warped image.
use_exif_info	integer Default: 1 Enum: 0 1 Example: use_exif_info=1 Whether to try to auto orient image based on EXIF data. The processed image should have EXIF data, otherwise auto orientation will not be performed. Has no effect with tiff images (they're always auto oriented). Ignored with warped images (see `warped_image` or `image_type` parameter).

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "multipart/form-data" "application/json" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64" "application/x-sdk-descriptor" "application/x-sdk-descriptor-base64" "application/x-vl-xpk" "application/x-vl-xpk-base64"

Request Body schema:
image/jpeg

string <binary>

Responses

Request samples

Payload
python
python
bash

Content type

image/jpeg

No sample

Response samples

Content type

application/json

{"images": [{"error": {"error_code": 0,
"detail": "Success",
"desc": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"status": 1,
"filename": "penelope.jpeg",
"exif": {"make": "Apple",
"model": "iPhone 11",
"gps": {"latitude": "55.0, 45.0, 18.29",
"longitude": "37.0, 39.0, 16.32"
},
"software": "13.6.1",
"orientation": 6
},
"detections": {"face_detections": [{"verifications": [{"similarity": 0.5,
"status": true,
"face": {"face_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
}
],
"face_attributes": {"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"basic_attributes": {"age": 29,
"gender": 1,
"ethnicities": {"estimations": {"african_american": 1.92238889737406e-12,
"asian": 0.954671621322632,
"caucasian": 0.045328326523304,
"indian": 7.65100649502415e-10
},
"predominant_ethnicity": "asian"
}
},
"score": 0,
"url": "/6/attributes/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
]
},
"sample": {"face": {"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"url": "/6/samples/faces/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"attributes": {"mouth_attributes": {"occluded": 0,
"opened": 0.1,
"score": 0.999999165534973,
"smile": 0.2
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
}
},
"quality": {"light": 0.87,
"dark": 0.13,
"illumination": 0.1,
"specularity": 0.1,
"blurriness": 0.2
},
"landmarks5": [[72,
72
],
[240,
240
],
[154,
154
],
[119,
119
],
[259,
259
]
],
"landmarks68": [[8,
8
],
[14,
14
],
[28,
28
],
[48,
48
],
[72,
72
],
[102,
102
],
[134,
134
],
[168,
168
],
[213,
213
],
[262,
262
],
[306,
306
],
[345,
345
],
[376,
376
],
[392,
392
],
[397,
397
],
[399,
399
],
[394,
394
],
[2,
2
],
[22,
22
],
[50,
50
],
[79,
79
],
[106,
106
],
[165,
165
],
[199,
199
],
[236,
236
],
[278,
278
],
[317,
317
],
[137,
137
],
[136,
136
],
[136,
136
],
[136,
136
],
[119,
119
],
[135,
135
],
[154,
154
],
[174,
174
],
[193,
193
],
[40,
40
],
[57,
57
],
[83,
83
],
[108,
108
],
[84,
84
],
[58,
58
],
[203,
203
],
[222,
222
],
[249,
249
],
[277,
277
],
[258,
258
],
[229,
229
],
[119,
119
],
[130,
130
],
[149,
149
],
[167,
167
],
[185,
185
],
[222,
222
],
[259,
259
],
[232,
232
],
[200,
200
],
[177,
177
],
[155,
155
],
[134,
134
],
[127,
127
],
[152,
152
],
[170,
170
],
[190,
190
],
[250,
250
],
[193,
193
],
[172,
172
],
[152,
152
]
],
"face_quality": {"status": 0,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "image_width",
"object_value": 1000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "image_height",
"object_value": 2000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "aspect_ratio",
"object_value": 0.5,
"threshold_value": {"min": 0.1,
"max": 1
},
"result": 1
},
{"name": "face_width",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "face_height",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "indent_left",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_right",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_upper",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_lower",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "image_size",
"object_value": 100500,
"threshold_value": {"min": 10,
"max": 100600
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "illumination_uniformity",
"object_value": 0.6305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "dynamic_range",
"object_value": 0.5305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
}
]
}
}
}
}
],
"filtered_detections": {"face_detections": [{"filter_reasons": [{"filter_name": "pitch_threshold",
"object_value": 0,
"threshold_value": 0
}
],
"detection": {"filename": "1.jpg",
"sample": {"detection": {"attributes": {"mouth_attributes": {"occluded": 0,
"opened": 0.2,
"score": 0.999999165534973,
"smile": 0.1
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
}
},
"quality": {"light": 0.87,
"dark": 0.13,
"illumination": 0.1,
"specularity": 0.1,
"blurriness": 0.2
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"landmarks5": [[72,
72
],
[240,
240
],
[154,
154
],
[119,
119
],
[259,
259
]
],
"landmarks68": [[8,
8
],
[14,
14
],
[28,
28
],
[48,
48
],
[72,
72
],
[102,
102
],
[134,
134
],
[168,
168
],
[213,
213
],
[262,
262
],
[306,
306
],
[345,
345
],
[376,
376
],
[392,
392
],
[397,
397
],
[399,
399
],
[394,
394
],
[2,
2
],
[22,
22
],
[50,
50
],
[79,
79
],
[106,
106
],
[165,
165
],
[199,
199
],
[236,
236
],
[278,
278
],
[317,
317
],
[137,
137
],
[136,
136
],
[136,
136
],
[136,
136
],
[119,
119
],
[135,
135
],
[154,
154
],
[174,
174
],
[193,
193
],
[40,
40
],
[57,
57
],
[83,
83
],
[108,
108
],
[84,
84
],
[58,
58
],
[203,
203
],
[222,
222
],
[249,
249
],
[277,
277
],
[258,
258
],
[229,
229
],
[119,
119
],
[130,
130
],
[149,
149
],
[167,
167
],
[185,
185
],
[222,
222
],
[259,
259
],
[232,
232
],
[200,
200
],
[177,
177
],
[155,
155
],
[134,
134
],
[127,
127
],
[152,
152
],
[170,
170
],
[190,
190
],
[250,
250
],
[193,
193
],
[172,
172
],
[152,
152
]
],
"face_quality": {"status": 0,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 0.4
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "image_width",
"object_value": 1000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "image_height",
"object_value": 2000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "aspect_ratio",
"object_value": 0.5,
"threshold_value": {"min": 0.1,
"max": 1
},
"result": 1
},
{"name": "face_width",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "face_height",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "indent_left",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_right",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_upper",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_lower",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "image_size",
"object_value": 100500,
"threshold_value": {"min": 10,
"max": 100600
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "illumination_uniformity",
"object_value": 0.7305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "dynamic_range",
"object_value": 0.6305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
}
]
}
}
}
}
}
]
}
}
},
{"error": {"error_code": 0,
"desc": "Success",
"detail": "Success",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
},
"status": 1,
"filename": "raw image",
"detections": {"face_detections": [{"sample": {"face": {"url": "null,",
"sample_id": null,
"rect": {"x": 70,
"y": 40,
"width": 135,
"height": 181
}
}
},
"verifications": [{"similarity": 1,
"status": true,
"face": {"face_id": "d05dd4eb-05e2-4962-9a91-7a665a2b3d67"
}
},
{"similarity": 0.9951737645,
"status": true,
"face": {"face_id": "ed654332-f8ab-4030-b9bf-654d6790f865"
}
},
{"similarity": 0.9934924273,
"status": true,
"face": {"face_id": "14abd41f-6fe6-445d-b9eb-95d010c42ca9"
}
},
{"similarity": 0.9912151812,
"status": true,
"face": {"face_id": "c3618a84-e854-40a3-a12b-8c817652f941"
}
},
{"similarity": 0.9894505146,
"status": true,
"face": {"face_id": "280e3988-c26a-4cbd-beeb-4dfa9c6e211c"
}
}
],
"face_attributes": {"samples": [ ],
"attribute_id": null,
"url": null,
"score": 0.9952012300491333
}
}
],
"filtered_detections": {"face_detections": [ ]
}
}
}
]
}

verification options

Get options for the resource.

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

count verifiers

Count verifiers that satisfy the filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
description	string Records with descriptions similar to this parameter will be processed.

header Parameters

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/verifiers"

payload = {
    "description": "new verifier",
    "policies": {
        "verification_threshold": 0.5,
        "detect_policy": {
            "estimate_mask": 1
        },
        "extract_policy": {
            "extract_basic_attributes": 1
        },
        "storage_policy": {
            "attribute_policy": {
                "store_attribute": 1
            },
            "face_sample_policy": {
                "store_sample": 1
            }
        }
    }
}

# create verifier
requests.post(url, json=payload, headers=headers)

url = f"{url}/count"

# get verifiers count
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"verifiers_count": 4
}

count verifiers options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get verifier

Get verifier by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/verifiers"

payload = {
    "description": "new verifier",
    "policies": {
        "verification_threshold": 0.5,
        "detect_policy": {
            "estimate_mask": 1
        },
        "extract_policy": {
            "extract_basic_attributes": 1
        },
        "storage_policy": {
            "attribute_policy": {
                "store_attribute": 1
            },
            "face_sample_policy": {
                "store_sample": 1
            }
        }
    }
}

# create verifier
response = requests.post(url, json=payload, headers=headers)
verifierId = response.json()["verifier_id"]

url = f"{url}/{verifierId}"

# get verifier
response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"verifier_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"account_id": "0468ca85-f6ca-4841-b30c-5ccc26b6f397",
"description": "simple verifier",
"policies": {"verification_threshold": 0.99,
"detect_policy": {"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [1
],
"estimate_liveness": {"estimate": 1,
"quality_threshold": 0.7,
"liveness_threshold": 0.7
},
"liveness_states": [1
],
"estimate_deepfake": {"estimate": 1,
"real_threshold": 0.7,
"mode": 2
},
"deepfake_states": [1
],
"face_quality": {"estimate": 1,
"filter": 0,
"checks": {"image_format": {"estimate": 1,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"specularity_quality": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 1
}
},
"blurriness_quality": {"estimate": 1,
"threshold": {"min": 0.61,
"max": 1
}
},
"dark_quality": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"light_quality": {"estimate": 1,
"threshold": {"min": 0.57,
"max": 0.9
}
},
"head_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"head_roll": {"estimate": 1,
"threshold": {"min": -8,
"max": 8
}
},
"gaze_yaw": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"gaze_pitch": {"estimate": 1,
"threshold": {"min": -5,
"max": 5
}
},
"mouth_smiling": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_occluded": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"mouth_open": {"estimate": 1,
"threshold": {"min": 0,
"max": 0.5
}
},
"glasses": {"estimate": 1,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 1,
"threshold": ["open"
]
},
"right_eye": {"estimate": 1,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 1,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 1,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 1,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 1,
"threshold": {"min": 90,
"max": 1920
}
},
"image_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 1,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 1,
"threshold": {"min": 180,
"max": 1920
}
},
"indent_left": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_right": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_upper": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"indent_lower": {"estimate": 1,
"threshold": {"min": 20,
"max": 1920
}
},
"image_size": {"estimate": 1,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 1,
"threshold": ["neutral"
]
},
"smile_properties": {"estimate": 1,
"threshold": ["none"
]
},
"headwear_type": {"estimate": 1,
"threshold": ["none"
]
},
"natural_light": {"estimate": 1,
"threshold": 1
},
"radial_distortion": {"estimate": 1,
"threshold": 0
},
"red_eyes": {"estimate": 1,
"threshold": 0
},
"face_color_type": {"estimate": 1,
"threshold": ["color"
]
},
"illumination_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 1,
"threshold": {"min": 0.2,
"max": 1
}
},
"background_uniformity": {"estimate": 1,
"threshold": {"min": 0.5,
"max": 1
}
},
"shoulders_position": {"estimate": 1,
"threshold": ["parallel"
]
}
}
}
},
"extract_policy": {"extract_basic_attributes": 1,
"fd_score_threshold": 0.7
},
"storage_policy": {"attribute_policy": {"store_attribute": 0
},
"face_sample_policy": {"store_sample": 0
}
}
},
"create_time": "2019-08-24T14:15:22Z",
"last_update_time": "2019-08-24T14:15:22Z",
"version": 111
}

replace verifier

Update the verifier. You can not update a part of verifier, so you should specify all the fields for your handler.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Value: "application/json" Content type is `application/json`.

Request Body schema: application/json

description	string <= 128 characters Verifier user description.
	object

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"description": "strict verifier",
"policies": {"verification_threshold": 0.9,
"detect_policy": {"multiface_policy": 0,
"estimate_head_pose": 0,
"estimate_emotions": 0,
"estimate_mask": 0,
"estimate_quality": 0,
"estimate_gaze": 0,
"estimate_glasses": 0,
"estimate_eyes_attributes": 0,
"estimate_mouth_attributes": 0,
"detect_landmarks68": 0,
"extract_exif": 0,
"yaw_threshold": 180,
"roll_threshold": 180,
"pitch_threshold": 180,
"mask_states": [ ],
"estimate_liveness": {"estimate": 0,
"liveness_threshold": 0.5,
"quality_threshold": 0.5
},
"liveness_states": [ ],
"estimate_deepfake": {"estimate": 0,
"real_threshold": 0.5,
"mode": 1
},
"deepfake_states": [ ],
"face_quality": {"estimate": 0,
"filter": 0,
"checks": {"image_format": {"estimate": 0,
"threshold": ["JPEG",
"JPEG2000",
"PNG"
]
},
"illumination_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"specularity_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"blurriness_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"dark_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"light_quality": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"head_roll": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_yaw": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"gaze_pitch": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_smiling": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_occluded": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"mouth_open": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.9
}
},
"glasses": {"estimate": 0,
"threshold": ["no_glasses",
"eyeglasses"
]
},
"left_eye": {"estimate": 0,
"threshold": ["open"
]
},
"right_eye": {"estimate": 0,
"threshold": ["open"
]
},
"head_horizontal_center": {"estimate": 0,
"threshold": {"min": 0.45,
"max": 0.55
}
},
"head_vertical_center": {"estimate": 0,
"threshold": {"min": 0.3,
"max": 0.5
}
},
"head_width": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 0.75
}
},
"head_height": {"estimate": 0,
"threshold": {"min": 0.6,
"max": 0.9
}
},
"eye_distance": {"estimate": 0,
"threshold": {"min": 91.1,
"max": 92.2
}
},
"image_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"image_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 1080
}
},
"aspect_ratio": {"estimate": 0,
"threshold": {"min": 0.74,
"max": 0.8
}
},
"face_width": {"estimate": 0,
"threshold": {"min": 180,
"max": 1920
}
},
"face_height": {"estimate": 0,
"threshold": {"min": 180,
"max": 0
}
},
"indent_left": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_right": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_upper": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"indent_lower": {"estimate": 0,
"threshold": {"min": 20,
"max": 0
}
},
"image_size": {"estimate": 0,
"threshold": {"min": 5120,
"max": 2097152
}
},
"eyebrows_state": {"estimate": 0,
"threshold": ["neutral"
]
},
"headwear_type": {"estimate": 0,
"threshold": ["none"
]
},
"smile_properties": {"estimate": 0,
"threshold": ["none"
]
},
"face_color_type": {"estimate": 0,
"threshold": ["color"
]
},
"natural_light": {"estimate": 0,
"threshold": 0
},
"red_eyes": {"estimate": 0,
"threshold": 0
},
"radial_distortion": {"estimate": 0,
"threshold": 0
},
"illumination_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"dynamic_range": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_uniformity": {"estimate": 0,
"threshold": {"min": 0.5,
"max": 1
}
},
"background_lightness": {"estimate": 0,
"threshold": {"min": 0.2,
"max": 1
}
},
"shoulders_position": {"estimate": 0,
"threshold": ["parallel"
]
}
}
}
},
"extract_policy": {"extract_basic_attributes": 0,
"fd_score_threshold": 0.7
},
"storage_policy": {"attribute_policy": {"store_attribute": 0
},
"face_sample_policy": {"store_sample": 0
}
}
}
}

Response samples

Content type

application/json

{"version": 111
}

check if verifier exists

Check if verifier with verifier_id exists.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/verifiers"

payload = {
    "description": "new verifier",
    "policies": {
        "verification_threshold": 0.5,
        "detect_policy": {
            "estimate_mask": 1
        },
        "extract_policy": {
            "extract_basic_attributes": 1
        },
        "storage_policy": {
            "attribute_policy": {
                "store_attribute": 1
            },
            "face_sample_policy": {
                "store_sample": 1
            }
        }
    }
}

# create verifier
response = requests.post(url, json=payload, headers=headers)
verifierId = response.json()["verifier_id"]

url = f"{url}/{verifierId}"

# check verifier
response = requests.head(url, headers=headers)

print(response.status_code)

remove verifier

Remove verifier by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {"Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE="}

url = f"{baseUri}/verifiers"

payload = {
    "description": "new verifier",
    "policies": {
        "verification_threshold": 0.5,
        "detect_policy": {
            "estimate_mask": 1
        },
        "extract_policy": {
            "extract_basic_attributes": 1
        },
        "storage_policy": {
            "attribute_policy": {
                "store_attribute": 1
            },
            "face_sample_policy": {
                "store_sample": 1
            }
        }
    }
}

# create verifier
response = requests.post(url, json=payload, headers=headers)
verifierId = response.json()["verifier_id"]

url = f"{url}/{verifierId}"

# delete verifier
response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

verifier options

Get options for the resource.

path Parameters

verifier_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

Verifier ID.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

ws

ws handshake

Ws handshake.

Attention!

Subscription to events occurs via WebSocket. Messages sent by ws you can view in callback section. Connection supports autoping.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

sources

string

Example: sources=cam1,cam2

Comma-separated list of sources. Each event from result will contain one of given sources.

stream_ids

string <list of uuid.>

Example: stream_ids=8950722f-3fd4-4223-b48f-03f95f0e8dfb,346a5645-ec89-4806-820a-dbcb6e0dc381

Comma-separated list of stream IDs.

matching_candidates_labels

string

Example: matching_candidates_labels=matching_label_1,matching_label_2

Comma-separated list of matching candidates label. Each event from result will contain one or more given labels.

object_similarity__gte

number

Example: object_similarity__gte=0.5

Object similarity lower included bound (boundary for top matching candidate).

object_similarity__lt

number

Example: object_similarity__lt=0.5

Object similarity upper excluded bound (boundary for top matching candidate).

age__lt

integer

Example: age__lt=50

Age upper excluded bound.

age__gte

integer

Example: age__gte=50

Age lower included bound.

gender

integer

Enum: 0 1

Example: gender=1

Gender. 1 - male, 0 - female.

ethnic_groups

string <list of integer (1, 2, 3, 4)>

Example: ethnic_groups=1,2

Comma-separated list of dominant ethnic group. Each event from result will contain one of the given ethnic groups.

ethnicity	value
African american	1
Indian	2
Asian	3
Caucasian	4

liveness

string <list of integer (0, 1 ,2)>

Example: liveness=1,2

Comma-separated list of dominant liveness. Each event from result will contain one of the given liveness.

liveness	value
spoof	0
real	1
unknown	2

deepfake

string <list of integer(0, 1)>

Example: deepfake=0,1

Comma-separated list of dominant deepfakes. Each event from result will contain one of the given deepfake.

deepfake	value
fake	0
real	1

header Parameters

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

sync with luna3
async with luna3
async with websockets library
using curl

from luna3.lunavl.httpclient import LunaHttpClient

EXPECTED_EVENT_COUNT = 1

client = LunaHttpClient(origin='http://127.0.0.1:5000', api=6, login="luna@visionlabs.ru", password="luna")
with client.wsConnect() as ws:
    for _ in range(EXPECTED_EVENT_COUNT):
        WS_RESP = ws.recv()
        print(WS_RESP)

Response samples

Content type

application/json

{"event": {"face_attributes": {"attribute_id": "557d54ec-29ad-4f3c-93b4-c9092ef12515",
"basic_attributes": {"age": 31,
"gender": 1,
"ethnicities": {"estimations": {"asian": 3.581344942826803e-10,
"indian": 9.219499295942679e-12,
"caucasian": 8.45913916691643e-9,
"african_american": 1
},
"predominant_ethnicity": "african_american"
}
},
"score": 0.9883918166160583,
"url": "/6/attributes/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"samples": ["33bc3d2c-3c07-40af-8ee8-9c03e036b0ae"
]
},
"body_attributes": {"score": 1,
"samples": ["4d5766a3-2e39-4909-88c0-ac9f07c426eb"
]
},
"source": "3rd Avenue",
"stream_id": "a778c4a5-2191-476e-a261-3b4f9ce2e25e",
"tags": ["tag1",
"tag2"
],
"event_id": "527fca61-d452-4dd2-ad97-63c5f95c02b1",
"url": "/6/events/527fca61-d452-4dd2-ad97-63c5f95c02b1",
"matches": [{"label": "good guys",
"candidates": [{"face": {"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"account_id": "904e635f-3a47-4832-b4d6-d2d72ba78451",
"user_data": "fox1991",
"create_time": "2021-08-18T02:43:37.196724+03:00",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256"
},
"similarity": 0.5
}
]
},
{"label": "bad guys",
"candidates": [{"event": {"event_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"user_data": "fox1991",
"create_time": "2018-08-11T09:11:41.674Z",
"handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"source": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7"
},
"similarity": 0.3
}
]
}
],
"external_id": "external id",
"user_data": "some event",
"location": {"city": "Moscow",
"area": "CAO",
"district": "Mitino",
"street": "Schepkina",
"house_number": "1/2str3",
"geo_position": {"longitude": 36.616,
"latitude": 55.752
}
},
"detections": [{"filename": "penelope.jpeg",
"samples": {"face": {"sample_id": "33bc3d2c-3c07-40af-8ee8-9c03e036b0ae",
"detection": {"attributes": {"liveness": {"prediction": "spoof",
"estimations": {"quality": 0.7361597418785095,
"score": 0.600364089012146
}
},
"deepfake": {"prediction": "fake",
"score": 0.600364089012146
},
"mouth_attributes": {"score": 0.3884400725,
"occluded": 1.4e-8,
"smile": 0.6115599275,
"opened": 0.121500025
},
"eyes_attributes": {"left_eye": {"iris_landmarks": [[92,
92
],
[92,
92
],
[93,
93
],
[93,
93
],
[94,
94
],
[95,
95
],
[96,
96
],
[98,
98
],
[99,
99
],
[100,
100
],
[101,
101
],
[102,
102
],
[103,
103
],
[104,
104
],
[105,
105
],
[105,
105
],
[105,
105
],
[105,
105
],
[105,
105
],
[104,
104
],
[103,
103
],
[102,
102
],
[101,
101
],
[100,
100
],
[99,
99
],
[98,
98
],
[97,
97
],
[96,
96
],
[95,
95
],
[94,
94
],
[93,
93
],
[93,
93
]
],
"state": "open"
},
"right_eye": {"iris_landmarks": [[152,
152
],
[153,
153
],
[153,
153
],
[154,
154
],
[154,
154
],
[155,
155
],
[157,
157
],
[158,
158
],
[159,
159
],
[161,
161
],
[162,
162
],
[163,
163
],
[164,
164
],
[165,
165
],
[166,
166
],
[166,
166
],
[166,
166
],
[166,
166
],
[166,
166
],
[165,
165
],
[164,
164
],
[163,
163
],
[162,
162
],
[161,
161
],
[159,
159
],
[158,
158
],
[158,
158
],
[157,
157
],
[156,
156
],
[154,
154
],
[154,
154
],
[153,
153
]
],
"state": "open"
}
},
"emotions": {"predominant_emotion": "neutral",
"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
}
},
"mask": {"predominant_mask": "occluded",
"estimations": {"medical_mask": 0.020060448,
"missing": 0.3235525191,
"occluded": 0.6563870311
},
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"head_pose": {"pitch": 12.7464532852,
"roll": -2.9892115593,
"yaw": 17.7173442841
},
"gaze": {"yaw": -5.9912848473,
"pitch": -10.2646684647
}
},
"quality": {"blurriness": 0.9769582748000001,
"dark": 0.9542820454000001,
"illumination": 0.8248310089,
"specularity": 0.8472354412,
"light": 0.8179533482
},
"rect": {"x": 255,
"y": 101,
"width": 137,
"height": 183
},
"landmarks5": [[43,
66
],
[106,
63
],
[89,
105
],
[54,
133
],
[116,
128
]
],
"landmarks68": [[8,
8
],
[14,
14
],
[28,
28
],
[48,
48
],
[72,
72
],
[102,
102
],
[134,
134
],
[168,
168
],
[213,
213
],
[262,
262
],
[306,
306
],
[345,
345
],
[376,
376
],
[392,
392
],
[397,
397
],
[399,
399
],
[394,
394
],
[2,
2
],
[22,
22
],
[50,
50
],
[79,
79
],
[106,
106
],
[165,
165
],
[199,
199
],
[236,
236
],
[278,
278
],
[317,
317
],
[137,
137
],
[136,
136
],
[136,
136
],
[136,
136
],
[119,
119
],
[135,
135
],
[154,
154
],
[174,
174
],
[193,
193
],
[40,
40
],
[57,
57
],
[83,
83
],
[108,
108
],
[84,
84
],
[58,
58
],
[203,
203
],
[222,
222
],
[249,
249
],
[277,
277
],
[258,
258
],
[229,
229
],
[119,
119
],
[130,
130
],
[149,
149
],
[167,
167
],
[185,
185
],
[222,
222
],
[259,
259
],
[232,
232
],
[200,
200
],
[177,
177
],
[155,
155
],
[134,
134
],
[127,
127
],
[152,
152
],
[170,
170
],
[190,
190
],
[250,
250
],
[193,
193
],
[172,
172
],
[152,
152
]
],
"face_quality": {"status": 1,
"checks": [{"name": "image_format",
"object_value": "JPEG",
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
],
"result": 1
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"threshold_value": {"min": 0.3,
"max": 1
},
"result": 1
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"threshold_value": {"min": 0.61,
"max": 1
},
"result": 1
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"threshold_value": {"min": 0.57,
"max": 1
},
"result": 1
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"threshold_value": {"min": -8,
"max": 8
},
"result": 1
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"threshold_value": {"min": -5,
"max": 5
},
"result": 1
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"threshold_value": {"min": 0,
"max": 0.5
},
"result": 1
},
{"name": "glasses",
"object_value": "no_glasses",
"threshold_value": ["no_glasses",
"eyeglasses"
],
"result": 1
},
{"name": "left_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "right_eye",
"object_value": "open",
"threshold_value": ["open"
],
"result": 1
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"threshold_value": {"min": 0.45,
"max": 0.55
},
"result": 1
},
{"name": "head_vertical_center",
"object_value": 0.51,
"threshold_value": {"min": 0.3,
"max": 0.5
},
"result": 1
},
{"name": "head_width",
"object_value": 0.61,
"threshold_value": {"min": 0.5,
"max": 0.75
},
"result": 1
},
{"name": "head_height",
"object_value": 0.71,
"threshold_value": {"min": 0.6,
"max": 0.9
},
"result": 1
},
{"name": "eye_distance",
"object_value": 110,
"threshold_value": {"min": 90,
"max": null
},
"result": 1
},
{"name": "image_width",
"object_value": 1000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "image_height",
"object_value": 2000,
"threshold_value": {"min": 200,
"max": 1100
},
"result": 1
},
{"name": "aspect_ratio",
"object_value": 0.5,
"threshold_value": {"min": 0.1,
"max": 1
},
"result": 1
},
{"name": "face_width",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "face_height",
"object_value": 500,
"threshold_value": {"min": 400,
"max": 600
},
"result": 1
},
{"name": "indent_left",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_right",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_upper",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "indent_lower",
"object_value": 100,
"threshold_value": {"min": 10,
"max": 500
},
"result": 1
},
{"name": "image_size",
"object_value": 100500,
"threshold_value": {"min": 10,
"max": 100600
},
"result": 1
},
{"name": "eyebrows_state",
"object_value": "neutral",
"threshold_value": ["neutral"
],
"result": 1
},
{"name": "smile_properties",
"object_value": "smile_lips",
"threshold_value": ["none"
],
"result": 0
},
{"name": "headwear_type",
"object_value": "hat",
"threshold_value": ["none"
],
"result": 0
},
{"name": "natural_light",
"object_value": 1,
"threshold_value": 1,
"result": 1
},
{"name": "radial_distortion",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "red_eyes",
"object_value": 0,
"threshold_value": 0,
"result": 1
},
{"name": "face_color_type",
"object_value": "color",
"threshold_value": ["color"
],
"result": 1
},
{"name": "illumination_uniformity",
"object_value": 0.7305162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "dynamic_range",
"object_value": 0.6605162000656128,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"threshold_value": {"min": 0.5,
"max": 1
},
"result": 1
}
]
}
},
"url": "/6/samples/faces/33bc3d2c-3c07-40af-8ee8-9c03e036b0ae"
},
"body": {"sample_id": "4d5766a3-2e39-4909-88c0-ac9f07c426eb",
"detection": {"rect": {"x": 52,
"y": 65,
"width": 748,
"height": 895
},
"attributes": {"basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
},
"url": "/6/samples/bodies/4d5766a3-2e39-4909-88c0-ac9f07c426eb"
}
},
"detect_time": "2021-06-18T02:44:58.653485+03:00",
"detect_ts": 123.456,
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e"
}
],
"meta": {"foo": "bar"
},
"aggregate_estimations": {"face": {"attributes": {"liveness": {"prediction": "spoof",
"estimations": {"quality": 0.7361597418785095,
"score": 0.600364089012146
}
},
"deepfake": {"prediction": "fake",
"score": 0.600364089012146
},
"mask": {"estimations": {"medical_mask": 0.020060448,
"missing": 0.3235525191,
"occluded": 0.6563870311
},
"predominant_mask": "occluded",
"face_occlusion": {"predominant_occlusion": "correct",
"estimations": {"full": 0.019,
"clear": 0.02,
"correct": 0.6108324766,
"partially": 0.31,
"mouth": 0.0209,
"chin": 0.019097
}
}
},
"emotions": {"estimations": {"anger": 0.00894705578684807,
"disgust": 0.00000965219624049496,
"fear": 0.00121302821207792,
"happiness": 0.00129503419157118,
"neutral": 0.986027479171753,
"sadness": 0.00187553185969591,
"surprise": 0.000632198702078313
},
"predominant_emotion": "neutral"
}
}
},
"body": {"attributes": {"basic_attributes": {"apparent_age": 25,
"apparent_gender": 0
},
"upper_body": {"headwear": {"state": 0,
"apparent_color": "undefined"
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["white",
"black"
]
}
},
"lower_body": {"lower_garment": {"type": "trousers",
"colors": ["white",
"black"
]
},
"shoes": {"apparent_color": "black"
}
},
"accessories": {"backpack": {"state": 0
}
}
}
}
},
"track_id": "useful_track_id_number_1",
"face": {"external_id": "external id",
"face_id": "a9629ef8-148f-4630-8584-dcf52caf8374",
"url": "/6/faces/a9629ef8-148f-4630-8584-dcf52caf8374",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"user_data": "top face",
"avatar": "/6/samples/33bc3d2c-3c07-40af-8ee8-9c03e036b0ae",
"event_id": "527fca61-d452-4dd2-ad97-63c5f95c02b1"
}
},
"handler_id": "88c5dd7e-693b-4386-92bc-0c31a150a7d0",
"event-create-time": "2021-06-18T02:44:58.653485+03:00",
"event-end-time": "2021-06-18T02:44:58.653485+03:00",
"Luna-Request-id": "1623984298,375c6d96-09c7-4db3-91cc-f13e66288aa9"
}

ws handshake options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

liveness

predict liveness

Predict liveness probability in input images.

The response contains the probability that there is a real person in the image, and it is not a presentation attack.

"meta" and "x_meta" sections of the request are used for backward compatibility and are deprecated now.

The incoming images should correspond the requirements of the utilized Liveness version. See "Administrator’s manual" for details.

Liveness estimation is not supported for samples (warped images).

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

aggregate

integer

Default: 0

Enum: 1 0

Example: aggregate=1

Whether to aggregate liveness estimations.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).
Content-Type	string Enum: "image/jpeg" "image/png" "image/bmp" "image/x-portable-pixmap" "image/tiff" "multipart/form-data" "application/json" "image/x-jpeg-base64" "image/x-png-base64" "image/x-bmp-base64" "image/x-tiff-base64" "image/x-portable-pixmap-base64"

Request Body schema:
multipart/form-data

	object (LivenessMeta) Deprecated Device information. This information can significantly decrease the overall error rate. The "meta" object is not mandatory. If you are not sure about any of the parameters, set "UNKNOWN" value or don't pass meta. The specified meta is applied to all the images within the request.
x_meta	object Deprecated The JSON string with any additional information.
required	Array of image_binary_for_multipart (string) or image_base64_for_multipart (string) (image_list_for_multipart) non-empty

Responses

Request samples

Payload
python
python
bash

Content type

multipart/form-data

No sample

Response samples

Content type

application/json

{"images": [{"filename": "succeeded_image.jpg",
"status": 1,
"liveness": {"prediction": 1,
"estimations": {"probability": 0.93,
"quality": 0.95
}
},
"error": {"desc": "Success",
"detail": "Success",
"error_code": 0,
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
}
},
{"filename": "succeeded_image_2.jpg",
"status": 1,
"liveness": {"prediction": 1,
"estimations": {"probability": 0.85,
"quality": 0.88
}
},
"error": {"desc": "Success",
"detail": "Success",
"error_code": 0,
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-0"
}
},
{"filename": "failed_image.jpg",
"status": 0,
"liveness": null,
"error": {"desc": "Failed to decode image data",
"detail": "File decoding error",
"error_code": 32010,
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-32010"
}
}
],
"aggregate_estimations": {"liveness": {"prediction": 1,
"estimations": {"probability": 0.89,
"quality": 0.915
}
}
}
}

liveness options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

documents

get openapi documentation

Get service OpenApi documentation. If Accept request header is of type application/x-yaml, returns documentation in yaml format or returns html documentation, if Accept is text/html.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Accept required	string (accept_docs_handler) Enum: "application/x-yaml" "text/html" Acceptable type of receiving data.

Responses

Response samples

408
415
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get openapi documentation options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get development manual

Get sphinx documentation - Development Manual. After the request you will be redirected to the page /docs/dev/index.html

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get development documentation options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

config

get service configuration

Get service configuration. Passwords and tokens will be hidden in the response.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Accept	string Enum: "application/json" "text/plain" Acceptable type of receiving data.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
    "Authorization": "Basic bHVuYUB2aXNpb25sYWJzLnJ1Omx1bmE=",
}
url = f"{baseUri}/config"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"INFLUX_MONITORING": {"SEND_DATA_FOR_MONITORING": 0,
"VERSION": 2,
"ORGANIZATION": "ORGANIZATION_NAME",
"TOKEN": "********",
"BUCKET": "luna_monitoring",
"HOST": "127.0.0.1",
"PORT": 8086,
"USE_SSL": 0,
"FLUSHING_PERIOD": 1
}
}

get config options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

features

get platform features

Get information about platform features:

relevance of the license (license)
enabled estimations (estimations)
enabled modules (components)

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
"Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
}
url = f"{baseUri}/features"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

200
408
500
503
504

Content type

application/json

{"license": true,
"estimations": {"people_counter": true,
"face_quality": true,
"body_attributes": true,
"liveness": true,
"deepfake": true
},
"components": {"events": true,
"tasks": true,
"sender": true,
"image_store": true,
"handlers": true,
"lambdas": true
}
}

features options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

plugins

get list of plugins

Get list of service plugins:

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
"Luna-Request-Id": "1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a",
}
url = f"{baseUri}/plugins"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

200
408
500
503
504

Content type

application/json

{"plugins": [{"name": "string",
"running": 0
}
]
}

plugins options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

lambda [beta]

create lambda

Create a new lambda.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type required	string Value: "multipart/form-data" The request content type header.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: multipart/form-data

archive required	string <binary> Archive file with zip extension. Content-Type must be "application/zip".
required	object Lambda credentials. Content-Type must be "application/json".
	object Parameters for lambda. Content-Type must be "application/json".

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep
import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}
lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps(
                {"lambda_name": lambdaName, "description": "test description"}
            ), "application/json"),
        "parameters": (
            "parameters",
            json.dumps(
                {"lambda_type": "standalone"}
            ), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)

print(response.status_code)
print(response.json())

Response samples

202
400
403
409
500

Content type

application/json

{"lambda_id": "string"
}

get lambdas

Get lambdas according to filters.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
create_time__lt	string <date-time> (time) Example: create_time__lt=2018-08-11T09:11:41.674Z Upper bound for object create_time.
create_time__gte	string <date-time> (time) Example: create_time__gte=2018-08-11T09:11:41.674Z Lower included bound for object create_time.
page	integer >= 1 Default: 1 Page number.
page_size	integer [ 1 .. 1000 ] Default: 10 Number of items on page.
lambda_type	string Enum: "standalone" "handlers" "tasks" Lambda type.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

from datetime import datetime, timedelta
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}
accountId = "00000000-0000-4000-a000-000000000156"
lambdaId = str(uuid4())
lambdaName = str(uuid4())
timeDelta = timedelta(days=1)
params = {
    "account_id": accountId,
    "create_time__lt": datetime.utcnow().isoformat("T") + "Z",
    "create_time__gte": (datetime.utcnow() - timeDelta).isoformat("T") + "Z",
    "page": 1,
    "page_size": 100,
    "lambda_type": "standalone"
}
url = f"{baseUri}/lambdas/"

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"lambdas": [{"account_id": "string",
"lambda_id": "string",
"lambda_name": "first-lambda",
"description": "very useful lambda",
"version": 1,
"info": {"status": "running"
},
"lambda_type": "standalone",
"create_time": "2019-08-24T14:15:22Z",
"last_update_time": "2018-08-11T09:11:41.674Z",
"additional_user_docker_commands": [ ],
"base_image": {"name": "string",
"tag": "string"
}
}
]
}

validation lambda

Validate lambda.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type required	string Value: "multipart/form-data" The request content type header.

Request Body schema: application/zip

archive required	string <binary> Archive file with zip extension. Content-Type must be "application/zip".
required	object Parameters for lambda.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}
url = f"{baseUri}/lambdas/validator"

with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "parameters": (
            "parameters",
            json.dumps({"lambda_type": "standalone"}),
            "application/json",
        )
    }

response = requests.post(url, headers=headers, files=files)

print(response.status_code)

Response samples

400
408
500
503
504

Content type

application/json

{"errors": ["validation_error_one",
"validation_error_two"
]
}

put lambda

Update lambda. You cannot update a part of the lambda, so you should specify all the fields for your lambda.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type required	string Value: "multipart/form-data" The request content type header.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: multipart/form-data

archive required	string <binary> Archive file with zip extension. Content-Type must be "application/zip".
required	object Lambda credentials. Content-Type must be "application/json".
	object Parameters for lambda. Content-Type must be "application/json".

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps(
                {"lambda_name": str(uuid4()), "description": "new lambda description"}
            ), "application/json"),
        "parameters": (
            "parameters",
            json.dumps(
                {"lambda_type": "standalone"}
            ), "application/json"),
    }
response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Put lambda

files.update(
    {
      "credentials": (
            "credentials",
            json.dumps(
                {"lambda_name": str(uuid4()), "description": "new lambda description"}
            ), "application/json") 
    }
)
response = requests.put(url + lambdaId, headers=headers, files=files)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"version": 0
}

patch lambda

Patch lambda.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Content-Type	string Value: "application/json" The request content type header.
Luna-Account-Id	string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Deprecated Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a Account ID. An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID. User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Request Body schema: application/json

non-empty

lambda_name	string (lambda_name) Lambda name. Each user can create only lambdas with unique names.
description	string <= 256 characters Lambda description.

Responses

Request samples

Payload
python
python
bash

Content type

application/json

{"lambda_name": "first-lambda",
"description": "very useful lambda"
}

Response samples

Content type

application/json

Example

account_id_not_found

{"error_code": 11066,
"desc": "Bad/incomplete input data",
"detail": "Luna-Account-Id header not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-11066"
}

get lambda

Get lambda by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}
lambdaId = "64e61920-f5ca-4caf-8f2e-d0217e2e6c0f"
url = f"{baseUri}/lambdas/{lambdaId}"
params = {
    "account_id": "00000000-0000-4000-a000-000000000156",
}

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"account_id": "string",
"lambda_id": "string",
"lambda_name": "first-lambda",
"description": "very useful lambda",
"version": 1,
"info": {"status": "running"
},
"lambda_type": "standalone",
"create_time": "2019-08-24T14:15:22Z",
"last_update_time": "2018-08-11T09:11:41.674Z",
"additional_user_docker_commands": [ ],
"base_image": {"name": "string",
"tag": "string"
}
}

check lambda existence

Check existence of the lambda by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}
lambdaId = "64e61920-f5ca-4caf-8f2e-d0217e2e6c0f"
url = f"{baseUri}/lambdas/{lambdaId}"

response = requests.head(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

delete lambda

Remove lambda by ID.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import requests
import json
from uuid import uuid4


baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps(
                {"lambda_name": lambdaName, "description": "lambda description"}
            ), "application/json"),
        "parameters": (
            "parameters",
            json.dumps(
                {"lambda_type": "standalone"}
            ), "application/json"),
    }
response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Delete lambda

url = f"{baseUri}/lambdas/{lambdaId}"

response = requests.delete(url, headers=headers)

print(response.status_code)

Response samples

Content type

application/json

{"error_code": 12012,
"desc": "Bad/incomplete input data",
"detail": "Bad query parameters 'account_id'",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12012"
}

update lambda

Update lambda using latest base image.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the plugin.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps(
                {"lambda_name": lambdaName, "description": "lambda description"}
            ), "application/json"),
        "parameters": (
            "parameters",
            json.dumps(
                {"lambda_type": "standalone"}
            ), "application/json"),
    }
response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Update lambda

url = f"{baseUri}/lambdas/{lambdaId}/update"
response = requests.post(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"version": 0
}

get lambda image creation status

Get lambda image creation status by lambda ID.

If lambda image creation is in progress, lambda status will be waiting.

After lambda image creation will end, the lambda image creation job will be removed and status will be not_found.

For more information about lambda and lambda images statuses see development manual.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Get lambda image creation status

url = f"{baseUri}/lambdas/{lambdaId}/image/status"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"status": "not_found"
}

get lambda image creation logs

Get lambda image creation logs by lambda ID.

During the creation of the lambda image, it is possible to get logs to monitor the progress.

For more information about lambda and lambda images logs see development manual.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

tail_lines

integer [ 0 .. 4294967296 ]

Number of strings what will be return.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Get lambda image creation logs

url = f"{baseUri}/lambdas/{lambdaId}/image/logs"
params = {"tail_lines": 1}

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"logs": ["string"
]
}

get lambda status

Get lambda status by ID.

If lambda image creation is in progress, lambda status will be waiting.

For more information about lambda and lambda images statuses see development manual.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Get lambda image creation status

url = f"{baseUri}/lambdas/{lambdaId}/status"

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"status": "running"
}

get lambda logs

Get lambda logs by ID.

After lambda creation has been executed, there is possibility to get lambda logs.

For more information about lambda and lambda images logs see development manual.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization
tail_lines	integer [ 0 .. 4294967296 ] Number of strings what will be return.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Get lambda image creation logs

url = f"{baseUri}/lambdas/{lambdaId}/logs"
params = {"tail_lines": 1}

response = requests.get(url, headers=headers, params=params)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"logs": ["string"
]
}

lambda proxy [beta]

get lambda openapi documentation

Get lambda OpenApi documentation. If Accept request header is of type application/x-yaml, returns documentation in yaml format or returns html documentation, if Accept-Type is text/html

path Parameters

lambda_id

required

string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515

ID of the lambda.

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id	string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4... Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.
Accept required	string (accept_docs_handler) Enum: "application/x-yaml" "text/html" Acceptable type of receiving data.

Responses

Response samples

Content type

application/json

{"error_code": 42001,
"desc": "Object not found",
"detail": "Lambda with id 'e63e2a1f-f505-441c-8e11-b2dcd0385329' not found",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-12013"
}

proxy post request to lambda

Proxy POST request to lambda.

Request and response headers, query parameters and body description must be provided by lambda documentation.

Described headers will be processed and received independently of lambda behavior. In case of bearer authorization, the token must include view permissions for lambdas to process request.

Authorizations:

BasicAuthBearerAuthLunaAccountIdAuth

path Parameters

lambda_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515 ID of the lambda.
* (any_parameter)	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515 Any additional path parameter will be use as path parameter to lambda

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Luna-Account-Id

string <uuid> ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Deprecated

Example: 8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

Account ID.

An account is a limitation for all the user actions (matching, removing, updating and other) on data which does not have corresponding account ID. For example: it is impossible to attach a face with one account ID to a list with another account ID.

User can make a limited set of requests without this header (requests with methods GET, HEAD, OPTIONS, match requests and getting events statistics requests).

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda
def wait4start(lambdaId: str) -> None:
    """
    Wait for lambda start

    Args:
        lambdaId: lambda id
    """
    for _ in range(150):
        reply = requests.get(f"{baseUri}/lambdas/{lambdaId}/status", headers=headers).json()
        if reply["status"] == "running":
            break
        if reply["status"] == "terminated":
            raise Exception(f"Expected successfully lambda running. Lambda id: {lambdaId}")
        sleep(1)
    else:
        raise Exception(f"Lambda execution took more than 150 seconds. Lambda id: {lambdaId}")

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Post proxy request to lambda
path = "main"
url = f"{baseUri}/lambdas/{lambdaId}/proxy/{path}"

response = requests.post(url, headers=headers)

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

Example

auth_required

{"error_code": 11062,
"desc": "Forbidden",
"detail": "Specified token corrupted",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-11062"
}

proxy options request to lambda

Proxy OPTIONS request to lambda.

The response to options contains all the possible methods that can be proxyed to a lambda, but does not say which of them are implemented and which are not.

path Parameters

lambda_id required	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515 ID of the lambda.
* (any_parameter)	string <uuid> (uuid) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515 Any additional path parameter will be use as path parameter to lambda

query Parameters

account_id

string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]...

Example: account_id=8950722f-3fd4-4223-b48f-03f95f0e8dfb

Account ID filter. Will not have effect if Luna-Account-Id header is used for authorization

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library
from time import sleep

import json
from uuid import uuid4

import requests

baseUri = "http://127.0.0.1:5000/6"

headers = {
    "Authorization": "Basic bHVuYV9sYW1iZGFAdmlzaW9ubGFicy5ydTpsdW5h",
}

# Create lambda

lambdaName = str(uuid4())
url = f"{baseUri}/lambdas/"
with open("lambda.zip", "rb") as archive:
    files = {
        "archive": ("lambda.zip", archive.read(), "application/zip"),
        "credentials": (
            "credentials",
            json.dumps({"lambda_name": lambdaName, "description": "lambda description"}),
            "application/json",
        ),
        "parameters": ("parameters", json.dumps({"lambda_type": "standalone"}), "application/json"),
    }

response = requests.post(url, headers=headers, files=files)
lambdaId = response.json()["lambda_id"]
wait4start(lambdaId)

# Put proxy request to lambda
path = "main"
url = f"{baseUri}/lambdas/{lambdaId}/proxy/{path}"

response = requests.options(url, headers=headers)

print(response.status_code)
print(response.headers)

Response samples

Content type

application/json

Example

auth_required

{"error_code": 11062,
"desc": "Forbidden",
"detail": "Specified token corrupted",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-11062"
}

health

get health

Get health of service.

query Parameters

include_luna_services

integer

Default: 0

Enum: 0 1

Whether to perform healthchecks for dependent LUNA services.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

baseUri = "http://127.0.0.1:5000/6"

# make request
url = f"{baseUri}/healthcheck"
response = requests.get(url, params={"include_luna_services": 1})

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"execution_time": 0.123
}

healthcheck options

Get options for the resource.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}

get health (redirect)

Get health of service (redirect).

query Parameters

include_luna_services

integer

Default: 0

Enum: 0 1

Whether to perform healthchecks for dependent LUNA services.

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Request samples

python
python
bash

# This example is written using requests library

import requests

# make request
url = f"http://127.0.0.1:5000/healthcheck"
response = requests.get(url, params={"include_luna_services": 1})

print(response.status_code)
print(response.json())

Response samples

Content type

application/json

{"execution_time": 0.123
}

healthcheck options (redirect)

Get options for the resource (redirect).

header Parameters

Luna-Request-Id

string^[0-9]{10},[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4...

Example: 1536751345,8b8b5937-2e9c-4e8b-a7a7-5caf86621b5a

External request ID. Helps to uniquely identify messages in system logs that correspond to particular requests. If it was not set, the system will set it to the default format ("timestamp, UUID"). It will be returned with the response.

Responses

Response samples

408
500
503
504

Content type

application/json

{"error_code": 37002,
"desc": "Request timeout",
"detail": "Service did not receive a complete request message within 60 seconds",
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-37002"
}