# Pangu-CV-万物检测-V2
#### 功能介绍
该模型主要实现物体检测的功能，输入图片的base64码和**自定义的标签列表**，模型识别出图片中该类别所在的位置，会返回带有标签的检测框信息和画好框的图片base64编码。
![](https://support.huaweicloud.com/api-pangulm/public_sys-resources/note_3.0-zh-cn.png)
服务调用方式：
- 支持图片推理。
- 图片推理支持在线和边缘部署。
 
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
POST /
获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。
#### 请求参数
表1请求Header参数（Token认证） 
| 参数           | 是否必选        | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| X-Auth-Token | 是（云上部署模型填写） | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是           | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 参数值为"application/json"                                                                                                                                                        |
   
表2请求Header参数（API Key认证） 
| 参数             | 是否必选                            | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| X-Apig-AppCode | 是（云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写） | String | **参数解释：** API Key值。 用于获取操作API的权限。[API Key认证](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__section148602501261)响应消息头中X-Apig-AppCode的值即为API Key。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type   | 是                               | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 参数值为"application/json"                                                                                                                                                                   |
   
表3请求Body参数 
| 参数        | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| images    | 是    | String | **参数解释：** 被检测图片的base64编码。 **约束限制：** 支持识别PNG、JPEG、BMP、JPG、WEBP格式的图片。只支持单张图片输入，分辨率范围为1px-10000px，base64编码后的图片大小不超过10MB，且长短边比例不能高于5。默认只支持RGB三通道图片数据，其他通道的数据暂不支持。 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| threshold | 是    | Float  | **参数解释：** 检测框置信度的阈值。 **约束限制：** 不涉及 **取值范围：** \[0, 1\] **默认取值：** 不涉及                                                                                                                     |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数     | 参数类型                                                                 | 描述                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| result | [MultimodalDINOResult] object | **参数解释：** 检测结果信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
 表5MultimodalDINOResult 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| Box   | object | **参数解释：** 目标检测框坐标，\[检测框左上角到竖轴距离,目标框左上角到横轴距离, 检测框宽度, 检测框高度\]，{"X": x, "Y": y, "Width": w, "Height": h} **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Score | Float  | **参数解释：** 目标检测置信度。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                              |
| label | String | **参数解释：** 目标标签。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                              |
   
**状态码： 400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误信息。 |
   
#### 请求示例
```
{
    "threshold": 0.25,
    "images": "/9j/4AAQSkZJRgABAQAAAQABAAD/......"
}
```
#### 响应示例
```
{
"result": [
{
"Box": {
"Y": 0,
"Width": 100,
"X": 0,
"Height": 100
},
"Score": 0.9,
"label": "person"
}
]
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。