OCR 文字识别

通过 OCR(Optical Character Recognition)技术,自动识别图片或附件中的文字信息并回填到字段中。

业务场景

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

配置步骤

  1. 确认要识别的信息类型,在 CRM 中购买对应资源包。

购买 OCR 资源包

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

创建存储识别信息的字段

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

开启 OCR 能力

配置字段映射

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

OCR 自动回填

[!NOTE]
以上为图片的 OCR 识别图例,附件的 OCR 识别操作类似。

常见问题

支持格式

  • 图片请求格式:PNG、JPG、JPEG、BMP、TIFF、PNM、WebP
  • 发票识别:同时支持 PDF 和 OFD 格式

问题排查

以下五种常见情况会影响 OCR 识别准确度:

  1. 图片尺寸过小(小于 15px),无法进行识别。
  2. 图片画质太差,例如图片过暗,文字内容不可辨识。
  3. 文字内容存在水印、印章、褶皱等遮挡。
  4. 图片样式与接口支持类型不符(例如身份证识别只支持二代居民身份证,不支持护照、银行卡等)。
  5. 如果有返回错误码,请参考错误码排查问题。

错误码参考

错误码 错误信息 描述
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]
如果持续出现以上错误,请联系产研侧解决。

相关主题

2026-09-17
0 0