文档首页/ 盘古大模型 PanguLargeModels/ API参考/ API/ 模型推理接口/ CV大模型/ Pangu-CV-物体检测-S-2.1.0
更新时间：2025-07-29 GMT+08:00
查看PDF
分享

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

功能介绍

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

服务调用方式：

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

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"
        }
    ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： CV大模型

相关文档