ocr_通用函数

函数名：ocr_通用 / ocr_general

函数功能

对任意图片进行通用OCR识别，支持自定义识别提示词，按用户要求提取图片中的文字或结构化信息。支持返回原始JSON数据与字段标题行显示，满足票据、表单、合同、截图等多种非标场景的识别需求。

参数规范

参数名	类型	必填	示例	特殊说明
文件路径	String	是	"C:\\images\\form.jpg"	图片完整路径，支持jpg/jpeg/png/bmp格式
原始数据	Boolean	否	false	默认false，true返回原始JSON格式数据
显示标题	Boolean	否	false	默认false，true在首行显示字段标题行
识别提示词	String	否	"提取表格中的姓名和金额"	默认空字符串，仅在通用识别时有效，可自定义识别要求

使用案例

基础通用识别

问题描述：识别图片中的文字内容

公式演示：

=ocr_通用("C:\\images\\form.jpg")

输出效果：

识别内容
姓名：张三 金额：1000.00 日期：2024-05-12

自定义识别提示词

问题描述：按自定义要求提取图片中的姓名和金额字段

公式演示：

=ocr_通用("C:\\images\\form.jpg",,,"提取表格中的姓名和金额")

输出效果：

姓名	金额
张三	1000.00

显示字段标题行

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

公式演示：

=ocr_通用("C:\\images\\form.jpg",,1,"提取表格中的姓名和金额")

输出效果：

姓名	金额
张三	1000.00

返回原始JSON数据

问题描述：获取通用识别的原始JSON结果，便于二次处理

公式演示：

=ocr_通用("C:\\images\\form.jpg",1)

输出效果：

{"result":"姓名：张三 金额：1000.00 日期：2024-05-12"}

错误处理示例

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

公式演示：

=ocr_通用("")

输出效果：

文件路径不能为空

技术说明

识别原理

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

识别提示词说明

• 识别提示词参数仅在通用识别时有效，其他专项识别函数忽略该参数
• 提示词用于自定义识别要求，如"提取表格中的姓名和金额""识别合同中的甲方乙方信息"等
• 不填写提示词时，默认识别图片中的全部文字内容

异常处理

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

会员等级

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

扩展应用

批量通用识别

结合Excel批量文件路径，下拉调用本函数实现图片文字批量提取，便于影像资料数字化归档。

结合JSON处理函数

返回的原始JSON数据可配合json_提取值、Json转表格等函数进一步解析与结构化处理。

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