图像分类接口文档
一、接口描述
图像分类API主要用于对传入的图片进行分类预测。
二、图片要求
- 图片格式:JPG、JPEG、PNG。
- 图片像素尺寸:最小 30x30 像素,最大 4096x4096 像素。
- 图片文件大小:4MB。
- 图片长宽比:3:1以内。
三、调用方法及URL
调用方法:post
请求URL:请先创建拖拽式或者自动化项目的图像分类中进行模型训练,模型发布成功后可以在模型详情中查看url。
四、请求参数
1.query请求参数
公共请求参数
字段名称 | 必须 | 类型 | 示例值 | 说明 |
---|---|---|---|---|
neu_app_key | 是 | String | 90j3l329knb39204e3948204958n49c | 您的appkey,可在NeuHub买家中心控制台获取 |
备注: neu_app_key对应AppKey申请地址:http://neuhub.jd.com/user/baseInfo
2.header请求参数
业务请求参数
字段名称 | 必须 | 类型 | 示例值 | 说明 |
---|---|---|---|---|
Content-Type | 是 | String | application/json;charset=UTF-8 | JSON格式 |
3.body请求参数
业务请求参数
字段名称 | 必须 | 类型 | 示例值 | 说明 |
---|---|---|---|---|
base64 | 是 | String | {"base64":"/9j/4AAQ..."} | 图片base64编码值,需去掉图片头 |
五、请求代码示例
http post模型发布的url
Content-Type:application/json;charset=UTF-8
{
"base64" : "/9j/4AAQSkZJRgABAQAASABIAAD/4QBYRXhpZgAAT……"
}
六、返回值说明
- 返回参数
字段名称 | 类型 | 示例值 | 说明 |
---|---|---|---|
code | Number | 10000 | 返回结果,10000表示成功,非10000为对应错误号;错误号对应错误详情请看下文 |
predictResult | Object | {...} | 图像预测结果 |
+prediction | String | rap_gesture | 图像预测的结果分类名 |
+thresholdList | Object(Array) | [{…}{…}...] | 图像预测置信度数组 |
++name | String | heart_gesture | 图像分类名称 |
++threshold | Number | 0.0125 | 该分类的置信度 |
七、返回示例
{
"code":10000,
"predictResult":{
"prediction":"rap_gesture",
"thresholdList":[
{
"name":"heart_gesture",
"threshold":0.0125
},
{
"name":"other",
"threshold":0.9815
},
{
"name":"other_gesture",
"threshold":0.0019
},
{
"name":"rap_gesture",
"threshold":0.0042
}
]
}
}
八、错误码信息
- 错误码
错误码(code) | 错误信息(message) |
---|---|
10310 | 缺少必要参数 |
10311 | 参数有误 |
10440 | 图片类型错误 |
10441 | 图片大小超过限制 |
10442 | 图片像素超过限制 |
10443 | 图片比例超过限制 |
-2 | 服务器内部错误 |
2000 | 用户APPK错误 |
1100 | API返回消息不是200 |
2100 | 网关内部异常 |