主题
通用手写OCR
接口描述
通过光学字符识别技术,对手写文字图片进行识别.
请求说明
HTTP 方法:
POST
请求 URL:
/ai-cloud-face/api/ocr/handwritten
Header如下:
参数名称 | 值 |
---|---|
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
---|---|---|---|---|
img | 是 | String | 1-3000k | 待处理图片(base64 编码),原始图片大小需要小于 3M; |
busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}
返回说明
返回参数:
返回值名称 | 数据类型 | 长度 | 描述 |
---|---|---|---|
code | int | 1-8 | 返回结果,0表示成功 |
message | String | 1-255 | 返回码描述 |
data | Object | - | 返回的数据 |
-busFlowId | String | 1-64 | 业务流水号,业务系统唯一序列号 |
-flowId | String | 1-64 | 交易流水ID(建议保存) |
-generalCode | String[] | - | 识别到所有文本行信息 |
-message | OcrHandwrittenRet[] | - | 文本行和文本行的坐标信息 |
OcrRet对象:
返回值名称 | 数据类型 | 长度 | 描述 |
---|---|---|---|
data | String | 1-511 | 属性值 |
p1 | Point | - | 坐标1 |
p2 | Point | - | 坐标2 |
p3 | Point | - | 坐标3 |
p4 | Point | - | 坐标4 |
Point对象:
返回值名称 | 数据类型 | 长度 | 描述 |
---|---|---|---|
x | int | 1-4 | x坐标 |
y | int | 1-4 | y坐标 |
返回示例:
{
"code": 0,
"data": {
"generalCode": [
"寻找与众不同的你",
"期待你的加入!"
],
"message": [{
"data": "寻找与众不同的你",
"p1": {
"x": 22,
"y": 60
},
"p2": {
"x": 432,
"y": 60
},
"p3": {
"x": 432,
"y": 119
},
"p4": {
"x": 22,
"y": 119
}
},
{
"data": "期待你的加入!",
"p1": {
"x": 27,
"y": 176
},
"p2": {
"x": 173,
"y": 176
},
"p3": {
"x": 173,
"y": 198
},
"p4": {
"x": 27,
"y": 197
}
}
]
},
"success": true,
"message": "success"
}
错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
码值 | 是否成功 | 是否计费 | 描述 |
---|---|---|---|
00000000 | 是 | 否 | 成功 |
50028100 | 否 | 否 | 图片不能为空 |
50028103 | 否 | 否 | 图片大小不能超过3M |
50028289 | 否 | 否 | 通用手写体识别异常 |
50028253 | 否 | 否 | 引擎检测异常 |
50028254 | 否 | 否 | 引擎检测异常 |
50028255 | 否 | 否 | 引擎检测异常 |