lambda API (v.0.0.0)

Download OpenAPI specification:Download

'VisionLabs lambda-unique-name' is luna user lambda.

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 (accept_docs_handler) Enum: "application/x-yaml" "text/html" acceptable type of receiving data

Responses

Response samples

Content type

application/json

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

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 <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.

Responses

Response samples

Content type

application/json

{"execution_time": 0.123
}

main

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-Account-Id required	string <uuid> (account_id) ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]... Example: 557d54ec-29ad-4f3c-93b4-c9092ef12515 Luna account Id. Designed to identify the created object.
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.
Content-Type	string Value: "application/msgpack"

Request Body schema: application/msgpack

aggregate_attributes required	integer (aggregate_attributes) Default: 0 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	object (event_source_schema)
use_exif_info required	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

{"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",
"user_data": "fox1991"
},
"similarity": 0.3
}
],
"label": "bad guys"
}
],
"meta": {"key": "value"
},
"source": "3rd Avenue",
"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
}
]
}