指尖文字识别 API - 科大讯飞

curl --location -g --request POST 'http://dev-cn.your-api-server.comhttp[s]: //tyocr.xfyun.cn/v2/ocr' \ --header 'Content-Type: application/json' \ --data-raw '{ "common":{ "app_id":"xxxxxxxx" }, "business":{ "ent":"fingerocr", "mode" :"finger+ocr", "method" :"dynamic", "resize_w" :1080, "resize_h" :1080 }, "data":{ "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2..." } }'

{ "code": 0, "data": { "finger_ocr": { "char": { "id": 0, "list": [ { "content": "string", "coord": [ { "x": 0, "y": 0 } ], "score": 0 } ] }, "sent": { "content": "string", "coord": [ { "x": 0, "y": 0 } ] }, "word": { "id": 0, "list": [ { "content": "string", "coord": [ { "x": 0, "y": 0 } ], "score": 0 } ] } }, "finger_pos": { "angle": 0, "dir_x": 0, "dir_y": 0, "pos_x": 0, "pos_y": 0, "thickness": 0 }, "height": 0, "mode": "string", "version_engine": "string", "version_json": "string", "width": 0 }, "message": "string", "sid": "string" }

请求参数

Body 参数application/json

common

object

用于上传公共参数

必需

app_id

string

必需

在平台申请的appid信息

business

object

用于上传业务参数

必需

ent

string

必需

请求引擎类型，只支持fingerocr

mode

string

可选

模式，选择范围：finger,finger+ocr(默认值)。 finger模式：只进行手指检测，返回手指位置、方向、宽度等信息 finger+ocr模式：进行手指检测以及OCR识别，返回手指指向的字、词、句信息

method

string

可选

方法，取值：dynamic(默认值)。根据指尖位置裁剪感兴趣区域（ROI）进行OCR识别

resize_w

integer

可选

引擎内部处理模块输入图像宽度，取值范围：[1,65536]。若应用端上传图像宽为input_w，scale为缩放系数，则resize_w=input_w*scale。若不缩放直接按原图处理，引擎耗时会变长，建议根据实际情况测试以寻求最佳值

resize_h

integer

可选

引擎内部处理模块输入图像高度，取值范围：[1,65536]。若应用端上传图像高为input_h，scale为缩放系数，则resize_h=input_h*scale。若不缩放直接按原图处理，引擎耗时会变长，建议根据实际情况测试以寻求最佳值

data

object

必需

用于上传识别图像数据

image

string

必需

图像数据，base64编码大小不超过4M，支持jpg/png/bmp格式另外，图片分辨率500W像素以上，或者500W像素图片中的部分裁剪区域，图片中文字高度最好大于24像素，且包含不少于两个指节以上的手部区域，否则会影响识别效果

示例

返回响应

🟢200成功（mode=finger+ocr）

application/json

Body

code

integer

必需

data

object

必需

finger_ocr

object

必需

指尖文字识别结果，仅mode=finger+ocr时返回

finger_pos

object

手指信息

必需

height

integer

必需

mode

string

必需

version_engine

string

必需

version_json

string

必需

width

integer

必需

message

string

必需

sid

string

必需

🟢200成功（mode=finger）