更新时间:2025-07-29 GMT+08:00
分享

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

功能介绍

找出图像中所有感兴趣的目标,确定它们的位置和类别。物体检测-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参数见表3

表2 请求Header参数(Token认证)

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

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

表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。

约束限制:

不涉及

取值范围:

true:进行类间nms

默认取值:

不涉及

响应参数

状态码: 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" 
		} 
	]
}

状态码

请参见状态码

错误码

请参见错误码

相关文档