Luna-Lambda-Unit (v.3.1.8)

Download OpenAPI specification:Download

VisionLabs Luna Lambda Unit API

main

generate events

Below is the data structure that will be sent by the luna handlers service to the lambda. This description can be changed by the lambda creator.

header Parameters

Luna-Request-Id

string <timestamp,uuid> ^[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 that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.

Request Body schema:
application/msgpack
required

aggregate_attributes required	integer (aggregate_attributes) Whether to aggregate attribute(s). If true, all extracted attributes will be aggregated and stored as a single attribute. Otherwise, all attributes will be stored for each sample. 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

Request samples

Payload

Content type

application/msgpack

No sample

Response samples

Content type

application/json

{"events": [{"aggregate_estimations": {"body": {"attributes": {"accessories": {"backpack": {"state": 0
}
},
"basic_attributes": {"apparent_age": 100,
"apparent_gender": 0
},
"lower_body": {"lower_garment": {"colors": ["black"
],
"type": "skirt"
},
"shoes": {"apparent_color": "black"
}
},
"upper_body": {"headwear": {"apparent_color": "black",
"state": 0
},
"sleeve": {"length": "short"
},
"upper_clothing": {"colors": ["black"
]
}
}
}
},
"face": {"attributes": {"emotions": {"estimations": {"anger": 1,
"disgust": 1,
"fear": 1,
"happiness": 1,
"neutral": 1,
"sadness": 1,
"surprise": 1
},
"predominant_emotion": "surprise"
},
"liveness": {"estimations": {"quality": 1,
"score": 1
},
"prediction": "spoof"
},
"mask": {"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"face_occlusion": {"estimations": {"chin": 0.2,
"clear": 0.05,
"correct": 0.25,
"full": 0.1,
"mouth": 0.2,
"partially": 0.2
},
"predominant_occlusion": "correct"
},
"predominant_mask": "medical_mask"
}
}
}
}
},
"body_attributes": {"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
],
"score": 1
},
"detections": [{"detect_time": "2018-08-11T09:11:41.674Z",
"detect_ts": 123.456,
"filename": "penelope.jpeg",
"image_origin": "/6/images/b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"samples": {"body": {"detection": {"attributes": {"accessories": {"backpack": { }
},
"basic_attributes": {"apparent_age": null,
"apparent_gender": null
},
"lower_body": {"lower_garment": { },
"shoes": { }
},
"upper_body": {"headwear": { },
"sleeve": { },
"upper_clothing": { }
}
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
}
},
"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"url": "/0/samples/bodies/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c"
},
"face": {"sample_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"url": "http://127.0.0.1:5020/1/buckets/visionlabs-samples/images/a16c8b6c-2818-4bae-9fd5-65acc8d4bb5c",
"detection": {"face_quality": {"checks": [{"name": "image_format",
"object_value": "JPEG",
"result": 1,
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
]
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.3
}
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.3
}
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.61
}
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.57
}
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"result": 1,
"threshold_value": {"max": 8,
"min": -8
}
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "glasses",
"object_value": "no_glasses",
"result": 1,
"threshold_value": ["no_glasses",
"eyeglasses"
]
},
{"name": "left_eye",
"object_value": "open",
"result": 1,
"threshold_value": ["open"
]
},
{"name": "right_eye",
"object_value": "open",
"result": 1,
"threshold_value": ["open"
]
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"result": 1,
"threshold_value": {"max": 0.55,
"min": 0.45
}
},
{"name": "head_vertical_center",
"object_value": 0.51,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0.3
}
},
{"name": "head_width",
"object_value": 0.61,
"result": 1,
"threshold_value": {"max": 0.75,
"min": 0.5
}
},
{"name": "head_height",
"object_value": 0.71,
"result": 1,
"threshold_value": {"max": 0.9,
"min": 0.6
}
},
{"name": "eye_distance",
"object_value": 110,
"result": 1,
"threshold_value": {"max": null,
"min": 90
}
},
{"name": "image_width",
"object_value": 1000,
"result": 1,
"threshold_value": {"max": 1100,
"min": 200
}
},
{"name": "image_height",
"object_value": 2000,
"result": 1,
"threshold_value": {"max": 1100,
"min": 200
}
},
{"name": "aspect_ratio",
"object_value": 0.5,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.1
}
},
{"name": "face_width",
"object_value": 500,
"result": 1,
"threshold_value": {"max": 600,
"min": 400
}
},
{"name": "face_height",
"object_value": 500,
"result": 1,
"threshold_value": {"max": 600,
"min": 400
}
},
{"name": "indent_left",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_right",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_upper",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_lower",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "image_size",
"object_value": 100500,
"result": 1,
"threshold_value": {"max": 100600,
"min": 10
}
},
{"name": "eyebrows_state",
"object_value": "neutral",
"result": 1,
"threshold_value": ["neutral"
]
},
{"name": "smile_properties",
"object_value": "smile_lips",
"result": 0,
"threshold_value": ["none"
]
},
{"name": "headwear_type",
"object_value": "hat",
"result": 0,
"threshold_value": ["none"
]
},
{"name": "natural_light",
"object_value": 1,
"result": 1,
"threshold_value": 1
},
{"name": "radial_distortion",
"object_value": 0,
"result": 1,
"threshold_value": 0
},
{"name": "red_eyes",
"object_value": 0,
"result": 1,
"threshold_value": 0
},
{"name": "face_color_type",
"object_value": "color",
"result": 1,
"threshold_value": ["color"
]
},
{"name": "illumination_uniformity",
"object_value": 0.4305162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "dynamic_range",
"object_value": 0.7605162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.2
}
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "shoulders_position",
"object_value": "parallel",
"result": 1,
"threshold_value": ["parallel"
]
}
],
"status": 0
},
"landmarks5": [ ],
"landmarks68": [ ],
"quality": {"blurriness": 0.2,
"dark": 0.13,
"illumination": 0.1,
"light": 0.87,
"specularity": 0.1
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"attributes": {"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"
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
},
"glasses": {"glasses": "no_glasses"
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"liveness": {"estimations": {"quality": 0.7190976739,
"score": 0.5108324766
},
"prediction": null
},
"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"face_occlusion": {"estimations": {"chin": 0.2,
"clear": 0.05,
"correct": 0.25,
"full": 0.1,
"mouth": 0.2,
"partially": 0.2
},
"predominant_occlusion": "correct"
},
"predominant_mask": "medical_mask"
},
"mouth_attributes": {"occluded": 0,
"opened": 0,
"score": 1,
"smile": 0
}
}
}
}
}
}
],
"event_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"external_id": "b668c4a5-2191-some-important-words",
"face": {"account_id": "d5c0a8c6-5509-4e5b-8a01-e2ab426542d6",
"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"user_data": "fox1991",
"url": "http://127.0.0.1:5030/3/faces/426542d6-5509-4e5b-8a01-e2abd5c0a8c6"
},
"face_attributes": {"attribute_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"basic_attributes": {"age": 29,
"ethnicities": {"estimations": {"african_american": 1.92238889737406e-12,
"asian": 0.954671621322632,
"caucasian": 0.045328326523304,
"indian": 7.65100649502415e-10
},
"predominant_ethnicity": "asian"
},
"gender": 1
},
"filter": {"filter_reasons": [{"filter_name": "score_threshold",
"object_value": 0,
"threshold_value": 0
}
],
"is_filtered": true
},
"samples": ["a3e8716f-70dc-42ad-8428-7a552e800a37"
],
"score": 1,
"url": "http://127.0.0.1:5030/3/attributes/24d405ce-bc56-4bf7-98e1-bdc962b4cf34"
},
"location": {"area": "string",
"city": "string",
"district": "string",
"geo_position": {"latitude": 55.752,
"longitude": 36.616
},
"house_number": "string",
"street": "string"
},
"matches": [{"candidates": [{"face": {"avatar": "https://st.kp.yandex.net/images/actor_iphone/iphone360_460188.jpg",
"create_time": "2018-08-11T09:11:41.674Z",
"event_id": "f9687459-986b-406d-9c1f-0d6289be5256",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"face_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c6",
"lists": ["429b0e78-4616-426a-b57f-02baa72d638d",
"6d037c33-31ec-4d73-b3b3-ec80b09446c2"
],
"user_data": "fox1991"
},
"similarity": 0.5
}
],
"label": "good guys"
},
{"candidates": [{"event": {"create_time": "2018-08-11T09:11:41.674Z",
"event_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"external_id": "2xQ2gprbMUePw1s9gw9fvA==",
"handler_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"source": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"stream_id": "426542d6-5509-4e5b-8a01-e2abd5c0a8c7",
"user_data": "fox1991"
},
"similarity": 0.3
}
],
"label": "bad guys"
}
],
"meta": {"key": "value"
},
"source": "3rd Avenue",
"stream_id": "b668c4a5-2191-476e-a261-3b4f9ce2e25e",
"tags": ["tag1",
"tag2"
],
"track_id": "useful_track_id_number_1",
"url": "http://127.0.0.1:5040/2/events/24d405ce-bc56-4bf7-98e1-bdc962b4cf34",
"user_data": "some data"
}
],
"filtered_detections": {"face_detections": [{"detection": {"filename": "penelope.jpeg",
"sample": {"detection": {"face_quality": {"checks": [{"name": "image_format",
"object_value": "JPEG",
"result": 1,
"threshold_value": ["JPEG",
"JPEG2000",
"PNG"
]
},
{"name": "illumination_quality",
"object_value": 0.6005162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.3
}
},
{"name": "specularity_quality",
"object_value": 0.7662366628646851,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.3
}
},
{"name": "blurriness_quality",
"object_value": 0.9429352283477783,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.61
}
},
{"name": "dark_quality",
"object_value": 0.9020983576774597,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "light_quality",
"object_value": 0.7881984114646912,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.57
}
},
{"name": "head_yaw",
"object_value": 2.818983316421509,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "head_pitch",
"object_value": 3.816443920135498,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "head_roll",
"object_value": 5.434040069580078,
"result": 1,
"threshold_value": {"max": 8,
"min": -8
}
},
{"name": "gaze_yaw",
"object_value": -3.773012399673462,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "gaze_pitch",
"object_value": 0.7140519022941589,
"result": 1,
"threshold_value": {"max": 5,
"min": -5
}
},
{"name": "mouth_smiling",
"object_value": 0.000290759839117527,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "mouth_occluded",
"object_value": 0.00009619363845558837,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "mouth_open",
"object_value": 0.6226108074188232,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0
}
},
{"name": "glasses",
"object_value": "no_glasses",
"result": 1,
"threshold_value": ["no_glasses",
"eyeglasses"
]
},
{"name": "left_eye",
"object_value": "open",
"result": 1,
"threshold_value": ["open"
]
},
{"name": "right_eye",
"object_value": "open",
"result": 1,
"threshold_value": ["open"
]
},
{"name": "head_horizontal_center",
"object_value": 0.51,
"result": 1,
"threshold_value": {"max": 0.55,
"min": 0.45
}
},
{"name": "head_vertical_center",
"object_value": 0.51,
"result": 1,
"threshold_value": {"max": 0.5,
"min": 0.3
}
},
{"name": "head_width",
"object_value": 0.61,
"result": 1,
"threshold_value": {"max": 0.75,
"min": 0.5
}
},
{"name": "head_height",
"object_value": 0.71,
"result": 1,
"threshold_value": {"max": 0.9,
"min": 0.6
}
},
{"name": "eye_distance",
"object_value": 110,
"result": 1,
"threshold_value": {"max": null,
"min": 90
}
},
{"name": "image_width",
"object_value": 1000,
"result": 1,
"threshold_value": {"max": 1100,
"min": 200
}
},
{"name": "image_height",
"object_value": 2000,
"result": 1,
"threshold_value": {"max": 1100,
"min": 200
}
},
{"name": "aspect_ratio",
"object_value": 0.5,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.1
}
},
{"name": "face_width",
"object_value": 500,
"result": 1,
"threshold_value": {"max": 600,
"min": 400
}
},
{"name": "face_height",
"object_value": 500,
"result": 1,
"threshold_value": {"max": 600,
"min": 400
}
},
{"name": "indent_left",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_right",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_upper",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "indent_lower",
"object_value": 100,
"result": 1,
"threshold_value": {"max": 500,
"min": 10
}
},
{"name": "image_size",
"object_value": 100500,
"result": 1,
"threshold_value": {"max": 100600,
"min": 10
}
},
{"name": "eyebrows_state",
"object_value": "neutral",
"result": 1,
"threshold_value": ["neutral"
]
},
{"name": "smile_properties",
"object_value": "smile_lips",
"result": 0,
"threshold_value": ["none"
]
},
{"name": "headwear_type",
"object_value": "hat",
"result": 0,
"threshold_value": ["none"
]
},
{"name": "natural_light",
"object_value": 1,
"result": 1,
"threshold_value": 1
},
{"name": "radial_distortion",
"object_value": 0,
"result": 1,
"threshold_value": 0
},
{"name": "red_eyes",
"object_value": 0,
"result": 1,
"threshold_value": 0
},
{"name": "face_color_type",
"object_value": "color",
"result": 1,
"threshold_value": ["color"
]
},
{"name": "illumination_uniformity",
"object_value": 0.4305162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "dynamic_range",
"object_value": 0.7605162000656128,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "background_lightness",
"object_value": 0.5780888795852661,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.2
}
},
{"name": "background_uniformity",
"object_value": 0.8874394297599792,
"result": 1,
"threshold_value": {"max": 1,
"min": 0.5
}
},
{"name": "shoulders_position",
"object_value": "parallel",
"result": 1,
"threshold_value": ["parallel"
]
}
],
"status": 0
},
"landmarks5": [ ],
"landmarks68": [ ],
"quality": {"blurriness": 0.2,
"dark": 0.13,
"illumination": 0.1,
"light": 0.87,
"specularity": 0.1
},
"rect": {"height": 240,
"width": 209,
"x": 170,
"y": 198
},
"attributes": {"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"
},
"gaze": {"pitch": 9.26744079589844,
"yaw": -19.4657287597656
},
"glasses": {"glasses": "no_glasses"
},
"head_pose": {"pitch": 18.6827487945557,
"roll": -10.3542232513428,
"yaw": 15.4102487564087
},
"liveness": {"estimations": {"quality": null,
"score": null
},
"prediction": "spoof"
},
"mask": {"estimations": {"medical_mask": 0.7108324766,
"missing": 0.0700698048,
"occluded": 0.2190976739
},
"face_occlusion": {"estimations": {"chin": 0.2,
"clear": 0.05,
"correct": 0.25,
"full": 0.1,
"mouth": 0.2,
"partially": 0.2
},
"predominant_occlusion": "correct"
},
"predominant_mask": "medical_mask"
},
"mouth_attributes": {"occluded": 0,
"opened": 0,
"score": 1,
"smile": 0
}
}
}
}
},
"filter_reasons": [{"filter_name": "pitch_threshold",
"object_value": 0,
"threshold_value": 0
}
]
}
]
},
"images": [{"error": {"desc": "External request failed",
"detail": "Failed  to download image by url 'https://www.gooogle.ru'",
"error_code": 11027,
"link": "https://docs.visionlabs.ai/info/luna/troubleshooting/errors-description/code-11027"
},
"exif": {"software": "Adobe Photoshop CS5 Macintosh"
},
"filename": "penelope.jpeg",
"status": 0,
"image_estimations": {"people": {"count": 0
}
}
}
]
}

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-Type is text/html

header Parameters

Luna-Request-Id	string <timestamp,uuid> ^[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 that correspond to particular requests, in system logs. If it was not set, system will set it in default format ("timestamp,UUID"). It will be returned with response.
Accept required	string Enum: "application/x-yaml" "text/html" acceptable type of receiving data

Responses

Response samples

Content type

application/json

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

health

get health

Get health of service.

header Parameters

Luna-Request-Id

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

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

Responses

Response samples

Content type

application/json

{"execution_time": 0.123
}

Luna-Lambda-Unit (v.3.1.8)

main

generate events

header Parameters

Request Body schema: application/msgpackapplication/jsonapplication/msgpackrequired

Responses

Request samples

Response samples

documents

get openapi documentation

header Parameters

Responses

Response samples

health

get health

header Parameters

Responses

Response samples

Request Body schema:
application/msgpack
required