Pangu-CV-物体检测-S-2.1.0

功能介绍

找出图像中所有感兴趣的目标，确定它们的位置和类别。物体检测-S模型特点是小参数量，适合在资源有限的环境中使用，提供较快的检测速度和合理的精度。

服务调用方式：

支持图片推理。
图片推理支持在线和边缘部署。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/infer-api/proxy/service/{deployment_id}/

获取URI方式请参见请求URI。

表1 推理接口路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID。约束限制：不涉及取值范围：不涉及默认取值：不涉及
deployment_id	是	String	参数解释：模型的部署ID，获取方法请参见获取模型部署ID。约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

使用Token认证方式的请求Header参数见表2。

表2 请求Header参数（Token认证）
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Content-Type	是	String	参数解释：发送的实体的MIME类型。约束限制：不涉及取值范围：不涉及默认取值： application/json

使用API Key认证方式的请求Header参数见表3。

表3 请求Header参数（API Key认证）
参数	是否必选	参数类型	描述
X-Apig-AppCode	是	String	参数解释： API Key值。用于获取操作API的权限。API Key认证响应消息头中X-Apig-AppCode的值即为API Key。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Content-Type	是	String	参数解释：发送的实体的MIME类型。约束限制：不涉及取值范围：不涉及默认取值： application/json

表4 请求Body参数
参数	是否必选	参数类型	描述
images	是	String	参数解释：被检测图片的base64编码。约束限制：建议整个请求体大小不超过4M。建议使用JPG、PNG、JPEG、BMP格式的图片。默认只支持RGB三通道图片数据，其他通道的数据暂不支持。取值范围：不涉及默认取值：不涉及
threshold	否	Float	参数解释：检测框置信度阈值。约束限制：不涉及取值范围：最小0.0，最大1.0 默认取值： 0.25

响应参数

状态码： 200

表5 响应成功Body参数
参数	参数类型	描述
result	Array of objects	参数解释：识别结果信息。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Score	Float	参数解释：置信度。约束限制：不涉及取值范围：不涉及默认取值：不涉及
label	String	参数解释：检测类别。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Box	Dict	参数解释：检测到的目标主体信息。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表6 Box
参数	参数类型	描述
X	Int	参数解释：矩形框左上角横坐标。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Y	Int	参数解释：矩形框左上角纵坐标。约束限制：不涉及取值范围：不涉及默认取值：不涉及
width	Int	参数解释：矩形框宽度。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Height	Int	参数解释：矩形框高度。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Angle	Int	参数解释：检测到的目标主体区域的角度。约束限制：不涉及取值范围：不涉及默认取值：不涉及

状态码： 400

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息。

请求示例

{
  "images": "/9j/4Vr2RXhpZgAASUkqAAgAAA.....",
  "threshold": 0.3
}

响应示例

{
    "result": [
        {
            "Box": {
                "Angle": 0,
                "Height": 60,
                "Width": 106,
                "X": 852,
                "Y": 182
            },
            "Score": 0.88427734375,
            "label": "car"
        },
        {
            "Box": {
                "Angle": 0,
                "Height": 114,
                "Width": 55,
                "X": 800,
                "Y": 170
            },
            "Score": 0.70556640625,
            "label": "person"
        }
    ]
}