印章检测
一、接口描述
1. 功能描述
天壤智能印章检测提取,是天壤OCR产品之一。天壤智能印章检测提取,支持对合同文件或常用票据中的印章进行检测,像素级比对识别仿制印章,广泛适用于商业合同文件检测与识别等业务场景中,检测准确率达95%以上,基于场景数据训练后准确率可以持续迭代和提升。
2. 接口数据要求
- 图片格式:base64编码
- 图片类型: jpg/jpeg/png
- 图片大小: 小于5M
- 若图片过大,建议使用压缩率较大的格式
3. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程。用户需要使用营业执照图片base64编码去做请求,使用其他图片的base64编码请求成功时也会加入计费。
二、请求说明
1. 接口地址:
https://aiapi.jd.com/tianrang/seal_detect
2. 请求方式
POST
3. 请求参数
(1)query请求参数
公共请求参数
名称 |
类型 |
必填 |
示例值 |
描述 |
appkey |
String |
是 |
21d2b762ecb86593f9668526920f46c |
您的appkey,可在买家中心控制台中获取 |
timestamp |
long |
是 |
1541491668961 |
请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign |
String |
是 |
6e148773a0337a8f2200ba90d445f083 |
签名,根据规则MD5(sectetkey+timestamp) |
名称 |
类型 |
必填 |
示例值 |
描述 |
Content-Type |
String |
true |
application/x-www-form-urlencoded |
标准编码格式 |
(3)body请求参数
名称 |
类型 |
必填 |
示例值 |
描述 |
media_id |
string |
true |
图像Base64编码值,去掉图片头"data:image/png;base64,", media_id=4AAQSk...}(由于过长,不给出示例) |
图片base64编码 |
(4)请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的2接口使用
三、返回说明
1.返回参数
(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)业务返回参数
名称 |
类型 |
示例值 |
描述 |
code |
number |
0 |
状态code |
requestId |
String |
98a39e53-84d4-448e-9081-29f64a6cd984 |
请求id |
message |
String |
success |
返回信息 |
data |
Object |
{...} |
data |
data字段说明
名称 |
类型 |
示例值 |
描述 |
bbox |
array |
[860,845,1025,1015] |
左上角坐标(x1,y1),右下角坐标(x2,y2) |
category |
number |
1 |
分类(目前只有一种) |
2.返回示例
{
"code": 0,
"data": [
{
"bbox": [
860,
845,
1025,
1015
],
"category": 1
}
],
"requestId": "559069148c9746dd8072340758e5e76b",
"message": "success"
}
四、错误码信息
1.系统级错误码
详见返回码
2.业务错误码
错误号(code) |
错误信息(message) |
描述 |
0 |
success |
成功 |
1000 |
param error |
参数错误 |
1001 |
sign error |
签名错误 |
1002 |
file error |
文件错误 |
1003 |
upload media error |
内部文件上传错误 |
1004 |
ai request error |
ai请求错误 |
1005 |
no authorization |
无权限认证 |
1006 |
form error |
表单错误 |
1100 |
system error |
系统内部错误 |