OCR 文字识别

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

业务场景

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

配置步骤

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

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

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

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

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

如果持续出现以上错误，请联系产研侧解决。

相关主题

• 图片字段
• 附件字段
• 字段概述