智能鉴黄
一、接口描述
1.功能描述
基于业界领先的深度学习图像识别技术,对图片影像的肤色、姿态和场景等进行智能识别 ,准确快速的输出每张图片“色情”、"低俗”、“性感”、“正常”的概率,其中色情图片准确 率高达 99.95%,有效的规避涉黄风险,让您的内容轻松过审核,成倍的解放审核人力。
2.接口数据要求
- 图片格式:jpg/jpeg、png
- 图片文件大小:小于2M
3.接口使用
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1.接口地址一:
https://aiapi.jd.com/jdai/cvImage
2.请求方式:
https get
aiapi.jd.com/jdai/cvImage
3.请求参数:
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
image_url | String | 是 | 略 | 图片完整url |
4.接口地址二:
https://aiapi.jd.com/jdai/localCvImage
5.请求方式:
post
6.请求参数:
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
(2)header请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
content type | String | 否 | application/octet-stream ,text/plain ... | 二进制流,文件类型.. |
(3)body请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
无 | ByteArrayRequestEntity | 是 | 略 | 图片二进制流 |
7.请求代码实例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的4接口使用
三、返回说明
1.公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
2.业务返回参数
result参数信息
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
status | int | 是 | 0 | 状态码 |
message | String | 是 | 正常 | 具体消息 |
request_id | String | 是 | 03ac182a-03e1-4802-840b-a33bd985619d | 请求id |
sexyScore | double | 是 | 0.2877 | 性感分数 |
pornScore | double | 是 | 0.2183 | 成人分数 |
vulgarScore | double | 是 | 0.1532 | 低俗分数 |
normalScore | double | 是 | 0.3409 | 正常分数 |
3.返回实例
{
"code":"10000",
"charge":false,
"remainTimes": 4998,
"remainSeconds": -1,
"msg":"查询成功",
"result":{
"status":0,
"message":"ok",
"request_id":"46e78874-3491-4a30-834e-98c0d76a1800",
"sexyScore":0.2877,
"pornScore":0.2183,
"vulgarScore":0.1532,
"normalScore":0.3409
}
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码(status) | message | 说明 |
---|---|---|
12001 | "illegal params" | 参数非法 |
12004 | "fail to download image" | 图片下载失败 |
12005 | "server exception" | 算法服务无法有效识别当前图片 |
12006 | "image content is empty" | 图片内容为空 |
12007 | "invalid image type ,just support png,jpg,jpeg" | 无效文件类型,仅支持png,jpeg,jpg |
12008 | "image url is empty" | 图片地址为空 |