本文导读

展开导读

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

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

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

查看PDF

功能介绍

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

说明：

服务调用方式：

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

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的权限。获取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编码。约束限制：建议使用PNG、JPEG、BMP、JPG、WEBP格式的图片。只支持单张图片输入，分辨率范围为1px-10000px，且长短边比例不能高于5。并且base64编码后的图片大小不超过10MB。支持RGB三通道格式的图像取值范围：默认取值：
nms_iou_thr	是	Float	参数解释：极大值抑制阈值。约束限制：取值范围：范围在0.0~1.0之间。默认取值：
agnositc_nms	是	Bool	参数解释：是否进行类间nms。约束限制：取值范围：是填写true，不是填写false。默认取值：

响应参数

状态码： 200

表5 响应Body参数
参数	参数类型	描述
result	List	物体检测的识别结果。

表6 响应Body参数
参数	参数类型	描述
RegisterMatrix	List	默认为[[1, 0, 0], [0, 1, 0], [0, 0, 1]]，表示图片特征矩阵。
Label	String	预测类别。
Score	Float	置信度。
Box	Dict	检测到的目标主体信息，格式为{"x":x1,"y":y1,"width":w,"height":h，'Angle':angle}。 x：检测到的目标主体区域的左上角x坐标。 y：检测到的目标主体区域的左上角y坐标。 width：检测到的目标主体区域的宽度。 height：检测到的目标主体区域的高度。 angle: 检测到的目标主体区域的角度。

状态码： 400

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

请求示例

图片请求示例

{ 
  "nms_iou_thr":0.45,
  "agnositc_nms":false,
  "images": "/9j/4Vr2RXhpZgAASUkqAAgAAA....." 
}

响应示例

{ 
    "result": [ 
		{ 
			"RegisterMatrix": [ 
				[ 
					1, 
					0, 
					0 
				], 
				[ 
					0, 
					1, 
					0 
				], 
				[ 
					0, 
					0, 
					1 
				] 
			] 
		}, 
		{ 
			"Box": { 
				"Y": 0, 
				"Width": 100, 
				"Angle": 0, 
				"X": 0, 
				"Height": 100 
			}, 
			"Score": 0.9, 
			"label": "person" 
		} 
	]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： CV大模型

上一篇：Pangu-CV-物体检测-S-2.1.0

下一篇：预测大模型

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问