本文先容了调用图片异步检测接口识别卡证单据分类OCR的设施。卡证单据分类OCR大约自动识别出图片包含哪种类型的卡证或单据,以特殊中的翰墨信息,并以结构化的方式复返翰墨本色。若是您仅知说念图片中包含卡证或单据,关联词不知说念卡证或单据的类型男同 按摩,保举您使用该场景。
卡证单据分类OCR当今支撑识别以下卡证或单据类型:身份证、驾驶证、行驶证、银行开户许可证、户口簿户主页、户口簿常住东说念主口页、不动产证、房产讲解、火车票、出租车票、定额发票、汽车购置发票。
(图片异步检测)使用讲解业务接口:/green/image/asyncscan,暗意图片异步检测。
您不错调用该接口创建图片异步检测任务。对于怎样构造HTTP央求,请参见央求结构;您也不错平直选用已构造好的HTTP央求,更多信息男同 按摩,请参见SDK概览。
经典av 计费信息:该接口为收费接口。对于计费方式,请参见本色安全产物订价。
检测超时:同步检测允许的最长检测时辰是6秒,若是检测在该时辰铁心内莫得完成,系统会强制复返超时造作码。若是您对及时性条目不高,不错采用异步检测,其他情况下请采用同步检测,同步检测接口的调用相对浅陋些。对于同步检测接口的调用,提议您将超时常间竖立为6秒。
复返赶走:异步检测任务不会及时复返检测赶走,您需要通过callback或者轮询的方式取得检测赶走。检测赶走最长保留一小时。
callback取得检测赶走:提交异步检测任务时,在央求参数中传入callback参数,用来自动袭取检测赶走,具体请参见(异步检测)央求参数。 轮询取得检测赶走:提交异步检测任务时,无需传入callback参数;提交异步检测任务后,调用赶走查询接口取得检测赶走,具体请参见(图片异步检测赶走查询)使用讲解。 图片条目: 图片聚会支撑以下契约:HTTP和HTTPS。 图片支撑以下阵势:PNG、JPG、JPEG、BMP、GIF、WEBP。 图片大小铁心为20 MB以内(适用于同步和异步调用),高度或者宽度不可高出30,000像素(px),且图像总像素不高出2.5亿(px)。 图片下载时辰铁心为3秒内,若是下载时辰高出3秒,复返下载超时。 图片像素提议不低于256*256(px),像素过低可能会影响识别后果。 图片检测接口的反映时辰依赖图片的下载时辰。请保证被检测图片所在的存储管事沉稳可靠,提议您使用阿里云OSS存储或者CDN缓存等。 QPS铁心本接口的单用户QPS铁心为10次/秒。高出铁心,API调用会被限流,这可能会影响您的业务,请合理调用。
(异步检测)央求参数 称呼 类型 是否必须 示例值 刻画 bizType String 否 default 该字段用于秀丽您的业务场景。您不错通过本色安全规模台创建业务场景(具体操作,请参见自界说机审规范)。 scenes StringArray 是 ["ocr-classify"] 指定检测场景,取值:ocr-classify。 callback String 否 检测赶走回调见告您的URL,支撑使用HTTP和HTTPS契约的地址。该字段为空时,您必须定时轮询检测赶走。 content:JSON字符串阵势,请自行领悟回转成JSON对象。对于content赶走的示例,请参见查询检测赶走的复返示例。 seed String 否 aabbcc123 随即字符串,该值用于回调见告央求中的签名。由英翰墨母、数字、下划线(_)构成,不高出64个字符。由您自界说,用于在袭取到本色安全的回调见告时校验央求由阿里云本色安全管事发起。
cryptType String 否 SHA256 使用回调见告时(callback),竖立对回调见告本色进行加密的算法。本色安全会将复返赶走(由用户uid + seed + content拼接的字符串)按照您竖立的加密算法加密后,再发送到您的回调见告地址。取值: SHA256(默许):使用SHA256加密算法。 SM3:使用国密HMAC-SM3加密算法,复返十六进制的字符串,且字符串由小写字母和数字构成。举例,abc经国密SM3加密后复返66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0。
tasks JSONArray 是 指定检测对象,JSON数组中的每个元素是一个检测任务结构体。最多支撑100个元素,即每次提交100条本色进行检测,支撑100个元素的前提是需要将并发任务转机到100个以上。对于每个元素的具体结构刻画请参见task。 extras JSONObject 否 {"md5":"b826f8c0463604703e8036bbfc7e3f6d"} 独特信息。无需传入该参数。 表 1. task 称呼 类型 是否必须 示例值 刻画 dataId String 否 test_data_xxxx 数据ID。需要保证在一次央求中通盘的ID不疏通。 url String 是 https://www.aliyundoc.com/test_image_xxxx.png 待检测图片的URL。 (异步检测)复返数据 称呼 类型 示例值 刻画 code Integer 200 造作码,和HTTP状态码一致。更多信息,请参见众人造作码。
msg String OK 央求信息的反映音信。 dataId String test_data_xxxx 检测对象对应的数据ID。 taskId String img6B61Qz8ykX76Fz2OpjVnss-1s**** 检测任务的ID。 url String https://www.aliyundoc.com/test_image_xxxx.png 检测对象的URL。 extras JSONObject {"md5":"b826f8c0463604703e8036bbfc7e3f6d"} 独特调用参数,对应检测央求参数中的extras。 (异步检测)示例 (图片异步检测赶走查询)使用讲解业务接口:/green/image/results,暗意查询图片异步检测赶走。
您不错调用该接口查询图片异步检测任务的赶走。对于怎样构造HTTP央求,请参见央求结构;您也不错平直选用已构造好的HTTP央求,更多信息,请参见SDK概览。
计费信息:该接口不计费。
查询超时:提议您将查询终止竖立为30秒(即在提交异步检测任务30秒后查询赶走),最长不可超出4个小时,不然赶走将会丢失。
QPS铁心本接口的单用户QPS铁心为10次/秒。高出铁心,API调用会被限流,这可能会影响您的业务,请合理调用。
(赶走查询)央求参数 称呼 类型 是否必须 示例值 刻画 body JSONArray 是 ["taskId1"] 要查询的检测任务的taskId列表。数组中的元素个数不高出100个。您在提交检测任务后,不错从复返数据中取得检测任务的taskId。
(赶走查询)复返数据 称呼 类型 示例值 刻画 code Integer OK 造作码,和HTTP状态码一致。更多信息,请参见众人造作码。
msg String OK 央求信息的反映音信。 dataId String test_data_xxxx 检测对象对应的数据ID。 taskId String img6B61Qz8ykX76Fz2OpjVnss-1s$Kaw 检测任务的ID。 url String https://www.aliyundoc.com/test_image_xxxx.png 检测对象的URL。 extras JSONObject {"md5":"b826f8c0463604703e8036bbfc7e3f6d"} 独特调用参数,对应检测央求参数中的extras。 results JSONArray 复返赶走。调用告捷时(code=200),复返赶走中包含一个或多个元素。每个元素是个结构体,具体结构刻画请参见result。 表 2. result 称呼 类型 示例值 刻画 scene String ocr 检测场景,取值:ocr。 label String ocr 检测赶走的分类。取值: normal:图片中未识别出翰墨信息。 ocr:图片中包含翰墨信息。 suggestion String review 提议用户试验的操作,取值: pass:无需关心复返赶走。 review:关心识别出的翰墨信息。 rate Float 99.91 在OCR图文识别场景中,不错毋庸关心该复返值。 ocrCardInfo Object 自动识别出来的卡证或单据OCR信息,包含身份证、驾驶证、行驶证、银行开户许可证、户口簿户主页、户口簿常住东说念主口页、不动产证、房产讲解、火车票、出租车票、定额发票、汽车购置发票。具体结构请参见ocrCardInfo。 表 4. 驾驶证信息(driverLicenseFrontInfo) 称呼 类型 示例值 刻画 name String 张三 姓名。 number String 123xxxxxxxxxxxxxxxx 驾驶证号。 birthDate String 03月01日 出身日历 address String xx省xx市xx区xx街说念xx号 住址。 nationality String 中国 国籍 issueDate String 2000年01月03日 首次领证日历 vehicleType String C1 准驾车型。 validStartDate String 2000年01月01日 有用期运行时辰,阵势:yyyy-MM-dd。 validEndDate String 2006年01月01日 有用期截止时辰,阵势:yyyy-MM-dd。 表 5. 行驶证正面信息(vehicleLicenseFrontInfo) 称呼 类型 示例值 刻画 plateNum String 陕xxxxxx 车招牌。 vehicleType String 微型平素客车 车辆类型。 owner String 张三 通盘者名字。 useCharacter String 非营运 车辆使用性质。 address String xx省xx市xx区xx街说念xx号 住址。 model String 东风日产牌ABCxxxxx 车辆品牌。 vin String ABCxxxxxxxx1234 车辆识别代号。 engineNum String 12xxxxA 发动机号码。 registerDate String 2000年01月01日 注册日历,阵势:yyyy-MM-dd。 issueDate String 2000年01月01日 发证日历,阵势:yyyy-MM-dd。 表 6. 银行开户许可证信息 称呼 类型 示例值 刻画 account String xxx 账号。 legalPerson String 张三 法定代表东说念主。 approvalNumber String J1**** 核准号。 name String xx信息手艺有限包袱公司 称呼。 title String 开户许可证 标题。 serialNumber String 1000-02312287 编号。 bankName String xx银行股份有限公司北京海淀支行 开户银行。 type String bank-account-permit 卡证的类型,取值固定为bank-account-permit,暗意银行开户许可证。 表 7. 户口簿户主页信息 称呼 类型 示例值 刻画 locationNumber String xxx 地段号。 issueDate String 2000年01月01日 签发日历。 householdType String 住户户口 户别。 houseHolder String 张三 户主姓名。 address String 广西xxx 住址。 community String xxx 户主社区。 householdNumber String xxx 户号。 undertaker String 汉 经办东说念主签章。 type String household-head 卡证的类型,取值固定为household-head,暗意户口簿户主页。 表 8. 户口簿常住东说念主口页信息 称呼 类型 示例值 刻画 occupation String 粮农 作事。 migrationDate1 String 2000年01月01日 何时由何地迁来本址。 idNumber String 12345620200101**** 身份证编号。 education String 初中 文化进度。 birthPlace String 2020年01月01日 出身地。 servicePremises String xxx 管事场地。 householdNumber String xxx 户号。 hometown String 四孔成齐 籍贯。 name String 支小宝 姓名。 formerName String xxx 曾用名。 maritalStatus String 只身 婚配气象。 nation String 汉族 民族。 otherAddress String xxx 本市其他住址。 birthday String 2020年01月01日 出身日历。 militaryService String xxx 兵役气象。 relationTo String 户主 与户主关连。 religion String xxx 宗教信仰。 bloodType String B 血型。 registerDate String 2023年02月06日 登记日历。 height String xxx 身高。 migrationDate2 String ivzi.03.zoxxx县xxx乡xxx村xx迁来 何时何地迁来本市。 undertaker String xxx 经办东说念主签章。 type String household-resident 卡证的类型,取值固定为household-resident,暗意户口簿常住东说念主口页。 表 9. 不动产证信息 称呼 类型 示例值 刻画 usage String 城镇住宅用地 用途。 rightType String 国有诱骗用地使用权/房屋通盘权 权益类型。 location String xx区xx镇xx村xx号 坐落。 otherInfo String 私有建筑面积:454.56m,分担建筑面积:28.mt房星结构:混杂房星总层数:3,房量所在层:1-3 权益其他气象。 rightNumber String 京(2017)通不动产权第001****号 证号。 buildingUnitNumber String 1101120002 不动产单元号。 rightProperty String 出让 权益性质。 rightHolder String 张三 权益东说念主。 sharedInfo String 房屋单独通盘 共多情况。 termLimit String 70 使用期限。 landNumber String xxx 丘权号。 area String 25766 面积。 constructionArea String 483.41 房屋建筑面积。 type String estate-cert 卡证的类型,取值固定为estate-cert,暗意不动产证。 表 10. 房产讲解信息 称呼 类型 刻画 usage String 用途、房屋用途。 rightType String 权益类型。 location String 坐落地址。 otherInfo String 权益其他气象。 rightNumber String 证号。 buildingUnitNumber String 不动产单元号。 rightProperty String 权益性质。 rightHolder String 权益东说念主。 sharedInfo String 共多情况。 termLimit String 使用期限、地皮使用年限。 landNumber String 丘权号。 area String 面积。 constructionArea String 房屋建筑面积。 rightProperty String 地皮权益性质、取得方式。 rightType String 房屋权益类型。 area String 建筑面积。 表 11. 火车票信息 称呼 类型 示例值 刻画 price String 0.0 票价。 ticketNumber String A000001 票号。 departureTime String 2019年01月01日00:00开 开车时辰。 seatType String 二等座 座位类型。 trainNumber String G0000 车次。 departure String 始发站 起程站。 departurePhonics String Shifa 起程站拼音。 seatNumber String 01车01F号 座位号。 destination String 终到站 到达站。 destinationPhonics String Zhongdao 到达站拼音。 passengerInfo String 1234567890****0000姓名 搭客信息。 type String train-ticket 单据的类型,取值固定为train-ticket,暗意火车票。 表 12. 出租车票信息 称呼 类型 示例值 刻画 actualCollection String 100 实收金额。 carNumber String A•T**** 车号。 date String 2008年9月16日 日历。 invoiceCode String 25000071**** 发票代码。 invoiceNumbe String 5485G0**** 发票号码。 mileage String 42.0km 里程。 amount String 100 金额。 getOffTime String 16:58 下车时辰。 boardingTime String [K068016:50 上车时辰。 totalAmount String 100 整个。 type String taxi-ticket 单据的类型,取值固定为taxi-ticket,暗意出租车票。 表 13. 定额发票信息 称呼 类型 示例值 刻画 amountInWords String 壹佰元 大写金额。 invoiceSerial String 发票代码领悟。 amountInFigures String 100 小写金额。 invoiceNumber String 0145**** 发票号码。 invoiceCode String 15113159**** 发票代码。 batchNumber String 01 批次号。 year String 2015 年份。 taxBureauCode String 国税 税务局代码。 invoiceIndustryCode String None 发票行业代码。 amountVersion String 电脑版 金额版。 regionalismCode String 南充市 行政区画代码。 invoiceCategoryCode String 发票换票证 发票类别代码。 type String quota-invoice 单据的类型,取值固定为quota-invoice,暗意定额发票。 表 14. 汽车购置发信息 称呼 类型 刻画 invoicingDate String 开票日历。 certificateNo String 及格证号。 phoneNo String 销货单元电话。 importNo String 入口讲解书号。 seller String 销货单元称呼。 taxDept String 主宰税务机关。 taxCode String 主宰税务代码。 bankName String 销货单元开户银行。 totalAmount String 价税整个(小写)。 vehicleType String 车辆类型。 invoiceNo String 发票号码。 engingNo String 发动机号码。 sellerAddr String 销货单元地址。 taxRate String 升值税税率或征收率。 vehicleNo String 车辆识别代号、车架号码。 serialExcludeTax String 完税确认号码。 buyerCode String 购买方身份证号码、组织机构代码。 sellerAccount String 销货单元账号。 sellerTaxId String 销货单元征税东说念主识一名。 amountInWords String 价税整个(大写)。 invoiceCode String 发票代码。 taxDeptAndCode String 主宰税务机关及代码。 origin String 产地。 priceExcludeTax String 不含税价。 buyer String 购买方称呼。 tax String 升值税税额。 inspectionNo String 商检单号。 buyerTaxId String 购买方征税东说念主识一名。 tonnage String 吨位。 capacity String 限乘东说念主数。 model String 厂牌型号。 (赶走查询)示例 身份证信息{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "b826f8c0463604703e8036bbfc7e3f6d" }, "results": [ { "rate": 99.91, "suggestion": "review", "label": "ocr", "ocrCardInfo": { "number": "***", "address": "***", "nationality": "*", "name": "***", "birth": "1989年9月28日", "type": "id-card" }, "scene": "ocr-classify" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "63134F39-EA65-471C-A571-35F72BCE9C79" }驾驶证信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "4c79bf6a1c831b12f88235b6dcfb59d5" }, "results": [ { "rate": 99.91, "suggestion": "review", "label": "ocr", "ocrCardInfo": { "number": "", "address": "xx省xx市路13号", "nationality": "中国", "name": "", "validStartDate": "2013-02-02", "type": "driver-license", "issueDate": "1994-02-02", "validEndDate": "2013-02-02至2023-02-02", "birthDate": "出身月期", "issueUnit": "XX省xx市公安局交视日历通窥伺支队透氧车型", "vehicleType": "A1A2" }, "scene": "ocr-classify" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "9BCCD309-7166-468E-9F4C-629D032A50EE" }行驶证信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "ac094bb290155692a3c340d15e905fcf" }, "results": [ { "rate": 99.91, "suggestion": "review", "label": "ocr", "ocrCardInfo": { "owner": "***", "address": "xx市xx区xx庄145号", "useCharacter": "非营运", "engineNum": "***", "vin": "***", "model": "别克牌SGM716xxxx", "type": "vehicle-license", "issueDate": "2012-01-06", "plateNum": "京", "vehicleType": "微型轿车", "registerDate": "2008-10-16" }, "scene": "ocr-classify" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "CFAF124B-8D0A-46A2-8730-E20EE26B5F8D" }房产讲解信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "de8f8ad850c2f74b3b96934f43de8bdb" }, "results": [ { "rate": 99.91, "suggestion": "review", "label": "ocr", "ocrCardInfo": { "rightHolder": "", "area": "", "termLimit": "年月日", "sharedInfo": "是", "usage": "年月日", "location": "在_省_市_(镇)", "rightProperty": "平方半上述房屋的通盘权东说念主是", "type": "estate-cert", "rightType": "房屋产权讲解范本" }, "scene": "ocr-classify" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "DEECF4C5-316E-468A-831D-507E763A9B02" }汽车购置发票信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "bc7f974425efe6732a84984ac3e24fc7" }, "results": [ { "rate": 99.91, "suggestion": "review", "label": "ocr", "ocrCardInfo": { "seller": "xx管事有限公司", "amountInWords": "69900", "priceExcludeTax": "59743.59", "taxDept": "xx市xx区国度税务局第二税务分局", "origin": "安徽", "inspectionNo": "", "bankName": "建行xx市分行", "type": "car-invoice", "sellerAddr": "xx市xx大路", "phoneNo": "028-266**", "buyerTaxId": "51021219821**", "capacity": "5", "invoicingDate": "2014-07-29", "taxDeptAndCode": "xx市xx区国度税务局第二税务分局1512002xxxx", "importNo": "", "serialExcludeTax": "¥59743.59小写", "sellerAccount": "5100168**", "sellerTaxId": "5120027**", "tonnage": "", "model": "**牌SQR716**", "invoiceNo": "0092xxxx", "vehicleType": "轿车", "engineNo": "AAEE0xxxx", "tax": "10156.41", "taxCode": "***", "certificateNo": "***", "invoiceCode": "**", "buyerCode": "***", "buyer": "***", "totalAmount": "69900.00", "taxRate": "17%", "vehicleNo": "***" }, "scene": "ocr-classify" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "D4E2ADEE-EFEC-42C8-8399-5BBEA79F9524" }