Human Shape Detection

Last Updated on : 2025-12-16 09:30:00download

Detect the human shapes in an image and return the specific coordinates of the human shapes. Up to five human shapes can be simultaneously detected in one image. >Note: Base64 encoded data does not include the image header, such as data:image/jpg;base64,.

API address

POST: /v1.0/iot-03/ai-vision/human-detection

Request parameter

Return parameter

Parameter name	Type	Description
result	List

Description of result

Parameter name	Type	Description
confidence	Float	A greater confidence value indicates higher accuracy. Valid values: 0–1.
coordinates	CoordinatesRes	The coordinates of a human shape in the image.

Description of coordinates

Parameter name	Type	Description
left	Integer	The distance between the human shape frame and the left border of the image, in pixels.
top	Integer	The distance between the human shape frame and the top border of the image, in pixels.
right	Integer	The distance between the human shape frame and the right border of the image, in pixels.
bottom	Integer	The distance between the human shape frame and the bottom border of the image, in pixels.

Request example

POST: /v1.0/iot-03/ai-vision/human-detection

{
  "image": "/9j/4AAQSkxxxxxxxxxxxxxxxx"
}

Return example

{
    "result": [
        {
            "confidence": 0.96324956,
            "coordinates": {
                "bottom": 932,
                "right": 777,
                "top": 10,
                "left": 0
            }
        }
    ],
    "t": 1618820271535,
    "success": true
}

Error code

For more information, see error code.