本文为您介绍目标检测（objectdet）类目下的猫鼠识别DetectKitchenAnimals的语法及示例。
功能描述
猫鼠识别能力基于视觉AI算法、物联网、大数据分析技术，猫鼠识别能力可以检测出场景中是否有猫、老鼠等动物，实现实时预警。
应用场景
餐饮后厨或仓库：针对后厨操作间、食材存储仓库等场地，实时检测是否有猫、老鼠等动物，并进行实时预警，提醒工作人员进行相应处理防范。
特色优势
- 识别准确：基于大量场景样本的基础上，对不同环境、光线、角度、目标状态等进行针对性的训练学习，算法模型识别精度高。
- 适应性强：算法模型场景适应性强，可直接用于不同空间布局的场景、各类餐厅后厨及用餐前场。
- 自研算法：通过多端多场景风险发现互通，形成检测、预警、整改、优化全链路闭环，结合数据分析、规则提取实现反哺生产，进而优化模型性能。
接入指引
1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
2. 开通能力：请确保您已开通目标检测服务，若未开通服务请立即开通。
3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。
4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。
5. 开发接入步骤：
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为目标检测（objectdet）类目的SDK包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
6. 示例代码：该能力常用语言的示例代码，请参见猫鼠识别示例代码。
7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式：JPG、JPEG、PNG、BMP。
- 图像大小：不超过4 MB，长宽比建议为16:9。
- 图像分辨率：大于1080×720像素。
- 输入的连续图像尺寸需要保持一致。
- 需要采集摄像头视角的图像。
- 图像URL地址中不能包含中文字符。
- 推荐的图像和检测目标的分辨率如下表所示。
计费说明
关于猫鼠识别的计费方式及报价，请参见计费介绍。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DetectKitchenAnimals | 系统规定参数。取值：DetectKitchenAnimals。 |
| ImageURLA | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectKitchenAnimals/DetectKitchenAnimals-left1.png | 图像A的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。 |
| ImageURLB | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectKitchenAnimals/DetectKitchenAnimals-right1.png | 图像B的URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | C306F16F-30E1-54F4-93DF-A52CCF6664D1 | 请求ID。 |
| Data | Object | 返回的结果数据内容。 |
|
| Elements | Array of elements | 检测结果。 |
|
| Type | String | mouse | 检测结果类型。取值如下：
|
| Score | Float | 0.75105053 | 检测结果概率值。 |
| Rectangles | Object | 检测目标位置。 |
|
| Top | Long | 1048 | 左上角X坐标，单位像素。 |
| Left | Long | 292 | 左上角Y坐标，单位像素。 |
| Height | Long | 64 | 高度，单位像素。 |
| Width | Long | 64 | 宽度，单位像素。 |
SDK参考
阿里云视觉AI目标检测类目下的猫鼠识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为目标检测（objectdet）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。
示例代码
该能力常用语言的示例代码，请参见猫鼠识别示例代码。
示例
请求示例
http(s)://objectdet.cn-shanghai.aliyuncs.com/?Action=DetectKitchenAnimals //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURLA=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectKitchenAnimals/DetectKitchenAnimals-left1.png
&ImageURLB=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectKitchenAnimals/DetectKitchenAnimals-right1.png
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectKitchenAnimalsResponse>
<RequestId>C306F16F-30E1-54F4-93DF-A52CCF6664D1</RequestId>
<Data>
<Elements>
<Type>mouse</Type>
<Score>0.75105053</Score>
<Rectangles>
<Left>292</Left>
<Top>1048</Top>
<Height>64</Height>
<Width>64</Width>
</Rectangles>
</Elements>
<Elements>
<Type>cat</Type>
<Score>0.4602436</Score>
<Rectangles>
<Left>1344</Left>
<Top>208</Top>
<Height>112</Height>
<Width>164</Width>
</Rectangles>
</Elements>
</Data>
</DetectKitchenAnimalsResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C306F16F-30E1-54F4-93DF-A52CCF6664D1",
"Data" : {
"Elements" : [ {
"Type" : "mouse",
"Score" : 0.75105053,
"Rectangles" : {
"Left" : 292,
"Top" : 1048,
"Height" : 64,
"Width" : 64
}
}, {
"Type" : "cat",
"Score" : 0.4602436,
"Rectangles" : {
"Left" : 1344,
"Top" : 208,
"Height" : 112,
"Width" : 164
}
} ]
}
}错误码
关于猫鼠识别的错误码，详情请参见常见错误码。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。