ocr_卡片种类函数

函数名：ocr_卡片种类 / ocr_card_type

函数功能

对卡片图片进行OCR识别，自动判断卡片种类（如身份证、银行卡、驾驶证、护照、社保卡、医保卡等），返回卡片类型信息。支持返回原始JSON数据与字段标题行显示，满足卡片自动分类、批量归档等多种场景需求。

参数规范

参数名	类型	必填	示例	特殊说明
文件路径	String	是	"C:\\images\\card.jpg"	卡片图片完整路径，支持jpg/jpeg/png/bmp格式
原始数据	Boolean	否	false	默认false，true返回原始JSON格式数据
显示标题	Boolean	否	false	默认false，true在首行显示字段标题行

使用案例

基础卡片种类识别

问题描述：识别卡片图片，自动判断卡片类型

公式演示：

=ocr_卡片种类("C:\\images\\card.jpg")

输出效果：

卡片类型
身份证

显示字段标题行

问题描述：识别卡片种类并在首行展示字段名称，便于核对字段含义

公式演示：

=ocr_卡片种类("C:\\images\\card.jpg",,1)

输出效果：

卡片类型
身份证

返回原始JSON数据

问题描述：获取卡片种类识别的原始JSON结果，便于二次处理

公式演示：

=ocr_卡片种类("C:\\images\\card.jpg",1)

输出效果：

{"card_type":"身份证"}

错误处理示例

问题描述：文件路径为空或文件不存在

公式演示：

=ocr_卡片种类("")

输出效果：

文件路径不能为空

技术说明

识别原理

• 底层调用远程OCR服务接口（/ocr/recognize），识别类型为card_type
• 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
• 异步执行，处理中返回"Waiting..."

返回字段

字段名	说明
卡片类型	识别出的卡片种类，如身份证、银行卡、驾驶证、护照、社保卡、医保卡等

异常处理

错误场景	返回值
文件路径为空	文件路径不能为空
文件不存在	文件不存在
图片格式不支持	不支持的图片格式
网络连接失败	网络请求失败
OCR识别异常	处理错误: 错误信息

会员等级

本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。

扩展应用

批量卡片分类

结合Excel批量文件路径，下拉调用本函数实现卡片图片批量自动分类，便于影像资料归档。

结合专项识别函数

先通过本函数判断卡片类型，再调用对应的专项识别函数（如ocr_身份证、ocr_银行卡）提取详细字段。

注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。