通过 OCR(Optical Character Recognition)技术,自动识别图片或附件中的文字信息并回填到字段中。
业务场景
| 类型 | 业务场景 |
|---|---|
| 卡证识别 - 身份证 | 自动识别并录入用户身份信息,应用于金融、保险、电商、O2O、直播等场景的实名身份认证,降低用户输入成本,控制业务风险 |
| 卡证识别 - 银行卡 | 金融远程身份认证,应用于金融场景用户实名认证,提升用户体验 |
| 卡证识别 - 营业执照 | 商家资质审查,应用于电商、零售、O2O 等行业的商户入驻审查,实现商户信息自动化审查和录入 |
| 卡证识别 - 户口本 | 身份信息登记,识别姓名、性别、出生地、出生日期、身份证号等,应用于政务办理场景 |
| 卡证识别 - 护照 | 应用于境外旅游产品预订、酒店入住登记等场景,满足护照信息自动录入需求 |
| 财务票据 - 票据 | 财税报销,快速完成各类报销凭证的自动切分及结构化识别,减轻员工报销难度,提升财务核算效率 |
| 交通场景 - 行驶证 | 司机身份认证,综合应用行驶证、驾驶证和身份证识别技术,自动识别录入用户身份信息和车辆信息 |
| 通用类型 | 纸质文档电子化,提高信息录入、存档、检索的效率 |
配置步骤
- 确认要识别的信息类型,在 CRM 中购买对应资源包。

- 创建好要存储识别信息的字段。例如想存储身份证上的姓名和身份证号信息。

- 资源包生效后,到对象里创建图片类型或附件字段(或使用已有字段),开启 OCR 能力,选择识别类型,配置字段映射。以下以身份证类型为例:


- 配置完成后,到对象新建数据页面,上传身份证图片,系统自动回填姓名、身份证号到页面字段上。

[!NOTE]
以上为图片的 OCR 识别图例,附件的 OCR 识别操作类似。
常见问题
支持格式
- 图片请求格式:PNG、JPG、JPEG、BMP、TIFF、PNM、WebP
- 发票识别:同时支持 PDF 和 OFD 格式
问题排查
以下五种常见情况会影响 OCR 识别准确度:
- 图片尺寸过小(小于 15px),无法进行识别。
- 图片画质太差,例如图片过暗,文字内容不可辨识。
- 文字内容存在水印、印章、褶皱等遮挡。
- 图片样式与接口支持类型不符(例如身份证识别只支持二代居民身份证,不支持护照、银行卡等)。
- 如果有返回错误码,请参考错误码排查问题。
错误码参考
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 1 | Unknown error | 未知错误,请再次请求 |
| 2 | Service temporarily unavailable | 服务暂不可用,请再次请求 |
| 3 | Unsupported openapi method | 调用的 API 不存在,请检查请求 URL |
| 4 | Open api request limit reached | 集群超限额,请再次请求 |
| 6 | No permission to access data | 无接口调用权限,请联系产研侧解决 |
| 17 | Open api daily request limit reached | 免费测试资源使用完毕,每天请求量超限额 |
| 18 | Open api qps request limit reached | QPS 超限额,开通按量后付费或购买次数包后并发限制为 10QPS |
| 19 | Open api total request limit reached | 请求总量超限额,请联系产研侧解决 |
| 100 | Invalid parameter | 无效的 access_token 参数,token 拉取失败 |
| 110 | Access token invalid | access_token 无效,token 有效期为 30 天,需定期更换 |
| 111 | Access token expired | access_token 过期,token 有效期为 30 天,需定期更换 |
| 216100 | invalid param | 请求中包含非法参数 |
| 216101 | not enough param | 缺少必须的参数 |
| 216102 | service not support | 请求了不支持的服务 |
| 216103 | param too long | 请求中某些参数过长 |
| 216110 | appid not exist | appid 不存在,请重新核对信息 |
| 216200 | empty image | 图片为空 |
| 216201 | image format error | 上传的图片格式错误(支持:PNG、JPG、JPEG、BMP、TIFF、PNM、WebP) |
| 216202 | image size error | 上传的图片大小错误(base64 编码后小于 4M,分辨率不高于 4096x4096) |
| 216306 | Upload file error | 上传文件失败,请检查请求参数 |
| 216308 | Pdf_file_num exceeds | 参数 pdf_file_num 大于 PDF 文件实际页数 |
| 216401 | Create task failed | 提交请求失败 |
| 216402 | Query task failed | 获取结果失败 |
| 216603 | Check pdf page num failed | 获取 PDF 文件页数失败 |
| 216604 | Insufficient available quota | 请求总量超限额,请购买或申请更多限额 |
| 216630 | recognize error | 识别错误,请确保图片中包含对应卡证票据 |
| 216631 | recognize bank card error | 识别银行卡错误(非正面、不完整或模糊) |
| 216633 | recognize idcard error | 识别身份证错误(非身份证、不完整或模糊) |
| 216634 | detect error | 检测错误,请再次请求 |
| 216600 | business verify failed | 企业核验相关服务请求失败(仅适用于企业核验相关服务) |
| 282000 | internal error | 服务器内部错误(高精度接口可能因文字过多导致超时,建议切割后识别) |
| 282003 | missing parameters | 请求参数缺失 |
| 282005 | batch processing error | 处理批量任务时发生部分或全部错误 |
| 282006 | batch task limit reached | 批量任务处理数量超出限制,请减少到 10 或以下 |
| 282100 | image transcode error | 图片压缩转码错误 |
| 282102 | target detect error | 未检测到图片中识别目标(非卡证图片或图片不完整/模糊) |
| 282103 | target recognize error | 图片目标识别错误(非卡证图片或图片不完整/模糊) |
| 282110 | urls not exist | URL 参数不存在 |
| 282111 | url format illegal | URL 格式非法 |
| 282112 | url download timeout | URL 下载超时(图片大小大于 3M 或存在防盗链) |
| 282113 | url response invalid | URL 返回无效参数 |
| 282114 | url size error | URL 长度超过 1024 字节或为 0 |
| 282134 | officialWeb service exception | 增值税发票验真接口,国税局端网络超时(建议次日重试) |
| 282808 | request id not exist | request id 不存在 |
| 282809 | result type error | 返回结果请求错误 |
| 282810 | image recognize error | 图像识别错误,请再次请求 |
[!TIP]
如果持续出现以上错误,请联系产研侧解决。