本文介绍了调用图片异步检测接口识别卡证票据混贴OCR的方法。卡证票据混贴OCR能够自动识别出图片中混贴的多个卡证或票据内容,以及其中的文字信息,并支持以结构化的方式返回文字信息。如果您需要识别票据报销类图片中的文字内容,推荐您使用该场景。
- 混贴发票:表示包含火车票、机票行程单、出租车票、定额发票、增值税发票、卷票、银行卡、驾驶证正页、户口簿户主页、户口簿常住人口页中一项或多项内容的图片。
- 混贴身份证:表示包含身份证人像面、身份证国徽面中一项或多项内容的图片。
- 混贴行驶证:表示包含行驶证正页、行驶证副页中一项或多项内容的图片。
(图片异步检测)使用说明
业务接口:/green/image/asyncscan,表示图片异步检测。
您可以调用该接口创建图片异步检测任务。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览。
- 计费信息:
该接口为收费接口。关于计费方式,请参见内容安全产品定价。
- 检测超时:
同步检测允许的最长检测时间是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"] | 指定检测场景,取值:ocr。 |
callback | String | 否 | http://www.aliyundoc.com/xx.json | 检测结果回调通知您的URL,支持使用HTTP和HTTPS协议的地址。该字段为空时,您必须定时轮询检测结果。 callback接口必须支持POST方法、UTF-8编码的传输数据,以及表单参数checksum和content。内容安全按照以下规则和格式设置checksum和content,调用您的callback接口返回检测结果。
说明 您的服务端callback接口收到内容安全推送的结果后,如果返回的HTTP状态码为200,则表示接收成功,其他的HTTP状态码均视为接收失败。接收失败时,内容安全将最多重复推送16次检测结果,直到接收成功。重复推送16次后仍未接收成功,则不再推送,建议您检查callback接口的状态。 |
seed | String | 否 | aabbcc123 | 随机字符串,该值用于回调通知请求中的签名。 由英文字母、数字、下划线(_)组成,不超过64个字符。由您自定义,用于在接收到内容安全的回调通知时校验请求由阿里云内容安全服务发起。 说明 当使用callback时,该字段必须提供。 |
cryptType | String | 否 | SHA256 | 使用回调通知时(callback),设置对回调通知内容进行加密的算法。内容安全会将返回结果(由用户uid + seed + content 拼接的字符串)按照您设置的加密算法加密后,再发送到您的回调通知地址。取值:
|
tasks | JSONArray | 是 | 指定检测对象,JSON数组中的每个元素是一个检测任务结构体。最多支持100个元素,即每次提交100条内容进行检测,支持100个元素的前提是需要将并发任务调整到100个以上。关于每个元素的具体结构描述,请参见task。 | |
extras | JSONObject | 是 | {"card":"multi-invoice"} | 指定要识别的混贴票据的类型,格式为{"card":"${CardType}"} 。CardType 表示票据类型,取值:
|
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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。 说明 如果在检测请求参数中传入了dataId,则此处返回对应的dataId。 |
taskId | String | img5AqOHIlzQRD5FMGNBO6F@t-1s$@Y0 | 检测任务的ID。 |
url | String | https://www.aliyundoc.com/test_image_xxxx.png | 检测对象的URL。 |
extras | JSONObject | {"card":"multi-invoice"} | 额外调用参数,对应检测请求参数中的extras。 说明 该参数可能会被调整,目前请勿依赖该参数的返回值。 |
(异步检测)示例
http(s)://[Endpoint]/green/image/asyncscan
&<公共请求参数>
{
"scenes": [
"ocr"
],
"extras": {
"card": "multi-invoice"
},
"tasks": [
{
"dataId": "test_data_xxxx",
"url": "https://www.aliyundoc.com/test_image_xxxx.png"
}
]
}
{
"code": 200,
"msg": "OK",
"requestId": "92AD868A-F5D2-4AEA-96D4-E1273B8E074C",
"data": [
{
"code": 200,
"msg": "OK",
"dataId": "test_data_xxxx",
"taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****",
"url": "https://www.aliyundoc.com/test_image_xxxx.png"
}
]
}
(图片异步检测结果查询)使用说明
业务接口:/green/image/results,表示查询图片异步检测结果。
您可以调用该接口查询图片异步检测任务的结果。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览。
- 计费信息:
该接口不计费。
- 查询超时:
建议您将查询间隔设置为30秒(即在提交异步检测任务30秒后查询结果),最长不能超出4个小时,否则结果将会丢失。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
(结果查询)请求参数
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
body | JSONArray | 是 | ["taskId1"] | 要查询的检测任务的taskId列表。数组中的元素个数不超过100个。 您在提交检测任务后,可以从返回数据中获取检测任务的taskId。 |
(结果查询)返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Integer | 200 | 错误码,和HTTP状态码一致。 更多信息,请参见公共错误码。 |
msg | String | OK | 请求信息的响应消息。 |
dataId | String | test_data_xxxx | 检测对象对应的数据ID。 说明 如果在检测请求参数中传入了dataId,则此处返回对应的dataId。 |
taskId | String | img5A@k7a@B4q@6K@d9nfKgOs-1sWeLu | 检测任务的ID。 |
url | String | https://www.aliyundoc.com/test_image_xxxx.png | 检测对象的URL。 |
extras | JSONObject | {"card":"bank-card"} | 额外调用参数,对应检测请求参数中的extras。 说明 该参数可能会被调整,目前请勿依赖该参数的返回值。 |
results | JSONArray | 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述请参见result。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
scene | String | ocr | 检测场景,取值:ocr。 |
label | String | ocr | 检测结果的分类。取值:
|
suggestion | String | review | 建议用户执行的操作,取值:
|
rate | Float | 99.91 | 在OCR图文识别场景中,可以不用关注该返回值。 |
multiCardInfo | JSONArray | 识别出来的卡证或票据信息,包含火车票、机票行程单、出租车票、定额发票、增值税发票、卷票、银行卡、驾驶证、户口簿户主页、户口簿常住人口页、身份证人像面、身份证国徽面、行驶证正页、行驶证副页。关于具体结构描述,请参见multiCardInfo。 |
表 3. 火车票信息 名称 类型 示例值 描述 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,表示火车票。 表 4. 机票行程单信息 名称 类型 示例值 描述 fare String 50.00 票价。 fuelSurcharge String xxx 燃油附加费。 serialNo String 706229** 印刷序号。 flight String xxx 航班号。 agentCode String CGO2750** 销售单位代号。 eTicketNo String 7R469550** 电子客票号码。 depart String 郑州 出发地。 issueOrg String xxxx航空服务公司 填开单位。 id String 41010519651** 有效身份证号码。 fund String xxx 明航发展基金。 passenger String 张三 旅客姓名。 insurance String xxx 保险费。 total String CNY630.00 合计。 date String xxx 日期。 arrive String 成都 目的地。 ck String xxx 校验码。 表 5. 出租车票信息 名称 类型 示例值 描述 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,表示出租车票。 表 6. 定额发票信息 名称 类型 示例值 描述 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,表示定额发票。 表 7. 增值税发票信息(invoiceInfo) 名称 类型 示例值 描述 invoice_name String **增值税专用发票 发票名称。 invoice_id Integer 110015**** 发票代码。 invoice_number Integer 5795**** 发票号码。 invoice_date Integer 20170422 开票日期。 invoice_bcompany String ****软件有限公司 购买方名称。 invoice_bcode String 91330000000000**** 购买方纳税人识别号。 invoice_baddress String **** 购买方地址、电话。 invoice_baccount String **银行某支行**** 购买方开户行及账号。 invoice_password String 1<000+0000-0000>79*27<>7295<-123020-8>07+63*683-80+>314-9+0+/<0-<-/1++35*958*6>98709/+9323858+8745<72461**** 发票密码。 invoice_detail Array 发票明细。 invoice_totalamount Float 4222.22 合计金额。 invoice_totaltax Float 717.78 合计税额。 invoice_totalamountupper String 肆仟玖佰肆拾圆整 价税合计(大写)。 invoice_totalamountlower String 4940.00 价税合计(小写)。 invoice_scompany String ****有限责任公司 销售方名称。 invoice_scode String 91110000000000**** 销售方纳税人识别号。 invoice_saddress String **** 销售方地址、电话。 invoice_saccount String ****支行1105011012340000**** 销售方开户行及账号。 invoice_remark String KP12**** 备注。 invoice_payee String xxx 收款人。 invoice_reviewer String xxx 复核。 invoice_drawer String 张女士 开票人。 表 8. 增值税发票明细(invoice_detail) 名称 类型 示例值 描述 detail_name String 荣莉龙芽花茶 货物或应税劳务、服务名称。 detail_type String xxx 规格型号。 detail_unit String xxx 单位。 detail_count Float 20 数量。 detail_unitprice Float 44.4444444 单价。 detail_amount Float 888.89 金额。 detail_rate String 17% 税率。 detail_tax Float 151.11 税额。 表 9. 卷票信息 名称 类型 示例值 描述 date String xxx 开票日期。 seller String xxx 销售方名称。 buyer String xxx 购买方名称。 taxNo String xxx 销售方税号。 total String xxx 总价。 ck String xxxx 校验码。 invoiceNo String 00000000 发票号码。 invoiceCode String 000000000000 发票代码。 buyerTaxCode String 00000000 购买方税号。 表 10. 银行卡信息(bankCardInfo) 名称 类型 示例值 描述 bankCardNum String 622576888888**** 银行卡号。 表 11. 驾驶证正面信息(driverLicenseFrontInfo) 名称 类型 示例值 描述 name String 张XX 姓名。 number String 123xxxxxxxxxxxxxxxx 驾驶证号。 address String xx省xx市xx区xx街道xx号 住址。 vehicleType String C1 准驾车型。 validStartDate String 2022-01-01 有效期开始时间,格式:YYYY-MM-DD。 validEndDate String 2028-01-01 有效期截止时间,格式:YYYY-MM-DD。 表 12. 户口簿户主页信息 名称 类型 示例值 描述 locationNumber String xxx 地段号。 issueDate String 2022年01月01日 签发日期。 householdType String 居民户口 户别。 houseHolder String 张XX 户主姓名。 address String 广西xxx 住址。 community String xxx 户主社区。 householdNumber String xxx 户号。 undertaker String xxx 承办人签章。 type String household-head 卡证的类型,取值固定为household-head,表示户口簿户主页。 表 13. 户口簿常住人口页信息 名称 类型 示例值 描述 occupation String 粮农 职业。 migrationDate1 String 2022年01月01日 何时由何地迁来本址。 idNumber String 5****************9 身份证编号。 education String 初中 文化程度。 birthPlace String xxx 出生地。 servicePremises String xxx 服务处所。 householdNumber String xxx 户号。 hometown String 四川成都 籍贯。 name String 张XX 姓名。 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 xxx县xxx乡xxx村xx迁来 何时何地迁来本市。 undertaker String xxx 承办人签章。 type String household-resident 卡证的类型,取值固定为household-resident,表示户口簿常住人口页。 表 14. 身份证信息(idCardInfo) 名称 类型 示例值 描述 name String 张XX 姓名。 nationality String 汉 民族。 number String 5****************9 身份证号。 birth String 2022-01-01 出生日期。格式:YYYY-MM-DD。 address String xxx 住址。 authority String xxx 签发机构。 startDate String 2022-06-30 有效期开始日期。格式:YYYY-MM-DD。 endDate String 2032-06-30 有效期结束日期。格式:YYYY-MM-DD。 说明 该字段可能返回以下值:长期。angle Float 96.2 证件顺时针旋转的角度。 copy Boolean false 身份证照片是否是复印件。取值: - true:是
- false:否
说明 默认不返回该字段。如果需要返回,请联系商务经理。remake Boolean false 身份证照片是否是翻拍。取值: - true:是
- false:否
说明 默认不返回该字段。如果需要返回,请联系商务经理。type String front 证件类型。取值: - front:身份证人像面
- back:身份证国徽面
- front_back:正常身份证人像面和国徽面同页
- interim_front:临时身份证人像面
- interim_back:临时身份证国徽面
- interim_front_back:临时身份证人像面和国徽面同页
numberValid Boolean true 证件号码是否合法。取值: - true:是
- false:否说明 如果长度不正确或者号码不符合国家规范,会返回false。
表 15. 行驶证正面信息(vehicleLicenseFrontInfo) 名称 类型 示例值 描述 plateNum String 陕xxxxxx 车牌号。 vehicleType String 小型普通客车 车辆类型。 owner String 张XX 所有者名字。 useCharacter String 非营运 车辆使用性质。 address String xx省xx市xx区xx街道xx号 住址。 model String 东风日产牌ABCxxxxx 车辆品牌。 vin String ABCxxxxxxxx1234 车辆识别代号。 engineNum String 12xxxxA 发动机号码。 registerDate String 2022-01-01 注册日期,格式:YYYY-MM-DD。 issueDate String 2022-01-01 发证日期,格式:YYYY-MM-DD。 表 16. 行驶证反面信息(vehicleLicenseBackInfo) 名称 类型 示例值 描述 plateNum String 陕Axxxxx 车牌号。 fileNum String 12345678**** 档案编号。 appprovedPassengerCapacity Integer xxx 核定载人数。 grossMass String xxx 总质量。 unladenMass String xxx 整备质量。 approvedLoad String xxx 核定载质量。 tractionMass String xxx 准牵引总质量。 inspectionRecord String 1 检验记录。 overallDimension Object 车辆轮廓尺寸信息。关于具体结构描述,请参见下表overallDimension。 表 17. overallDimension 名称 类型 示例值 描述 length Integer 4000 车辆长度,单位:毫米。 width Integer 2000 车辆宽度,单位:毫米。 height Integer 1000 车辆高度,单位:毫米。
(结果查询)示例
http(s)://[Endpoint]/green/image/results
&<公共请求参数>
[
"img5A@k7a@B4q@6K@d9nfKgOs-1s****"
]
- 卷票信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "d38999af9b6b2111568eda095029b768" }, "results": [ { "multiCardInfo": [ { "date": "", "seller": "", "total": "", "ck": "", "buyerTaxCode": "", "taxNo": "", "invoiceNo": "00000000", "type": "roll-ticket", "invoiceCode": "000000000000", "buyer": "" } ], "rate": 99.91, "suggestion": "review", "label": "ocr", "scene": "ocr" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1sW****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "3DC92A4B-2346-4519-B1C5-DD277AB3A5F8" }
- 机票行程单信息
{ "msg": "OK", "code": 200, "data": [ { "msg": "OK", "code": 200, "dataId": "test_data_xxxx", "extras": { "md5": "1f22c383a8b83479e91182def3ff1489" }, "results": [ { "multiCardInfo": [ { "insurance": "XXX", "date": "", "fare": "50.00", "flight": "", "agentCode": "CGO2750**", "eTicketNo": "7R469550**", "ck": "", "type": "flight-itinerary", "issueOrg": "xxxx航空服务公司", "serialNo": "706229**", "total": "CNY630.00", "fund": "", "passenger": "张三", "arrive": "成都", "id": "41010519651**", "fuelSurcharge": "", "depart": "郑州" } ], "rate": 99.91, "suggestion": "review", "label": "ocr", "scene": "ocr" } ], "taskId": "img5A@k7a@B4q@6K@d9nfKgOs-1s****", "url": "https://www.aliyundoc.com/test_image_xxxx.png" } ], "requestId": "FE52C03C-1BAA-4D16-B29C-750A45C65E26" }