文档首页 > > API参考> API> 智能分类识别

智能分类识别

分享
更新时间: 2019/10/30 GMT+08:00

功能介绍

检测定位图片上指定要识别的票证(票据、证件或其他文字载体),并对其进行结构化识别。

接口以列表形式返回图片上要识别票证的位置坐标、结构化识别的内容以及对应的类别。

计费次数说明:只对识别成功的票证进行计费,识别失败的票证不计费。例如图片中包含三张票证,有两张识别成功,一张识别失败,此时接口计费两次。

URI

URI格式:

POST /v1.0/ocr/auto-classification

请求消息

智能分类识别请求参数说明请参见表1

表1 请求参数

参数

是否必选

参数类型

说明

image

与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10M。

图片最小边不小于15像素,最长边不超过8000像素,支持JPEG/JPG/PNG/BMP/TIFF格式。

url

与image二选一

String

图片的URL路径,目前仅支持华为云上OBS提供的匿名公开授权访问的URL以及公网URL。

type_list

List

可以指定要识别的票证,指定后不出现在此List的票证不识别。不指定时默认返回所有支持类别票证的识别信息。

当前版本支持的票证类型请参见表2

表2 支持票证类型

票证类型

参数值

增值税发票

vat_invoice

出租车票

taxi_invoice

飞机行程单

flight_itinerary

机动车销售统一发票

mvs_invoice

身份证头像面

id_card_portrait_side

驾驶证主页

driver_license_front

行驶证主页

vehicle_license_front

道路运输证

transportation_license

定额发票

quota_invoice

火车票

train_ticket

车辆通行费发票

toll_invoice

护照

passport

身份证国徽面

id_card_emblem_side

驾驶证副页

driver_license_back

行驶证副页

vehicle_license_back

银行卡

bankcard

响应消息

智能分类识别响应参数说明请参见 表3
表3 响应参数

参数

参数类型

说明

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

result

Object

调用成功时返回的调用结果。

status

Object

指示各对应票证的识别状态。

content

Object

对应票证具体结构化识别的结果。

type

String

对应票证的类别。

location

List

各票证在原图上的坐标,依次分别为左上、右上、右下、左下。

confidence

Object

相关字段的置信度信息,置信度越大,表示本次识别的对应字段的可靠性越高,在统计意义上,置信度越大,准确率越高。

置信度由算法给出,不直接等价于对应字段的准确率。

示例

  • 请求样例(使用图片的BASE64编码)
    POST https://{endpoint}/v1.0/ocr/auto-classification
    
    Request Body: 
    {
       "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
    }

    Endpoint即调用API的请求地址,不同服务不同区域的Endpoint不同,具体请参见终端节点

    例如智能分类识别服务部署在“华北-北京四”区域的Endpoint为“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/auto-classification”。

  • 响应样例
    {
        "result": [
            {
                "status": {
                    "error_code": "AIS.0000", 
                    "error_msg": "Succeeded."
                }, 
                "type": "quota_invoice", 
                "location": [
                    [65, 1006], 
                    [1388, 1006], 
                    [1388, 1863], 
                    [65, 1863]
                ],
                "content": {               
                    "code": "131001661301",
                    "number": "40300888",
                    "amount": "¥50.00",              
                    "location": "上海", 
                    "confidence": {                    
                        "code": 0.9253, 
                        "number": 0.9665,
                        "amount": 0.9848,
                        "location": 0.9847 
                    }                
                }
            },
            {
                "status": {
                    "error_code": "AIS.0000", 
                    "error_msg": "Succeeded."
                }, 
                "type": "quota_invoice", 
                "location": [
                     [621, 605], 
                     [1328, 605], 
                     [1328, 1094], 
                     [621, 1094]
                ],     
                "content": {               
                    "code": "131001661301",
                    "number": "40300800",
                    "amount": "¥100.00",             
                    "location": "上海", 
                    "confidence": {                    
                        "code": 0.9556, 
                        "number": 0.9455,
                        "amount": 0.9917,
                        "location": 0.9347 
                    }                
                }
            },
            {
                "status": {
                    "error_code": "AIS.0104", 
                    "error_msg": "The image is not supported or the image quality is poor."
                }, 
                "type": "quota_invoice", 
                "location": [
                    [816, 103], 
                    [2125, 103], 
                    [2125, 978], 
                    [816, 978]
                ],
                "content": {}
            }
        ]
    }
  • 失败响应样例
    {
        "error_code": "AIS.0103", 
        "error_msg": "The image size does not meet the requirements." 
    }

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区