本文导读

展开导读

文档首页/ 盘古大模型 PanguLargeModels/ API参考/ API/ 模型推理接口/ CV大模型/ Pangu-CV-物体检测-S-2.1.0

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

更新时间：2025-06-20 GMT+08:00

查看PDF

功能介绍

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

说明：

服务调用方式：

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

URL

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的权限。获取Token接口响应消息头中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	矩形框左上角纵坐标。
With	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大模型

上一篇：Pangu-CV-图像分类-2.1.0

下一篇：Pangu-CV-物体检测-N-2.1.0

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问